skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
jd-opensource/joysafeter62 installs

pentest-recon-attack-surface

White-box attack surface mapping — correlate external scans, browser exploration, and source code into structured endpoint inventory, role architecture, and authorization vulnerability candidates.

How do I install this agent skill?

npx skills add https://github.com/jd-opensource/joysafeter --skill pentest-recon-attack-surface
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is a specialized pentesting tool for attack surface mapping and authorization analysis. It correlates data from external network scans, web crawls, and local source code analysis. The primary security concern is the potential for indirect prompt injection, as the skill processes external, untrusted data from targets without explicit sanitization or boundary markers, which could be used to manipulate the agent's findings or actions.

  • Socketwarn

    1 alert: gptSecurity

  • Snykwarn

    Risk: MEDIUM · 1 issue

  • Runlayerwarn

    3/3 files flagged

What does this agent skill do?

Pentest Recon Attack Surface

Purpose

Perform comprehensive attack surface mapping by correlating three data sources: external network scans, authenticated browser exploration, and source code analysis. Produces a structured endpoint inventory with authorization metadata, role/privilege architecture, and prioritized authorization vulnerability candidates for downstream code review and exploitation.

Prerequisites

Authorization Requirements

  • Written authorization with explicit scope for reconnaissance and source code access
  • Source code access to the target application (white-box engagement)
  • Test accounts at every privilege level (anonymous, user, admin, service)
  • Network scan approval — confirm acceptable scan intensity with target owner

Environment Setup

  • nmap, subfinder, httpx, whatweb for external reconnaissance
  • Playwright with authenticated browser contexts
  • katana or gospider for web crawling
  • ffuf for content discovery
  • semgrep and ripgrep for source code analysis
  • Access to deployment configs (Dockerfile, docker-compose, k8s manifests)

Core Workflow

  1. Technology Fingerprinting: Run whatweb + httpx to identify frameworks, languages, server versions, WAF presence, and response header signatures.
  2. External Scan Correlation: Execute nmap service scan + subfinder subdomain enumeration. Cross-reference discovered services against deployment configs (docker-compose ports, k8s service definitions) to identify exposed vs internal-only services.
  3. Interactive Browser Exploration: Authenticated Playwright crawl at each privilege level. Capture all XHR/fetch requests, form submissions, WebSocket connections, and dynamic route transitions. Record request/response pairs with auth context.
  4. Route Mapper: Parse all backend route definitions from source code with file:line pointers. Extract HTTP method, path pattern, middleware chain, and handler function for every endpoint.
  5. Authorization Checker: For each route, trace the middleware chain to identify auth/authz enforcement. Flag endpoints missing authentication middleware or with inconsistent authorization patterns.
  6. Input Validator: Analyze validation logic per parameter — identify parameters with no server-side validation, client-only validation, or incomplete validation (e.g., type check but no range check).
  7. Session Handler: Trace token lifecycle from issuance through validation to expiry. Map session storage mechanism, token rotation policy, and logout invalidation behavior.
  8. Authorization Architecture: Synthesize role definitions, permission assignments, and privilege lattice from source code. Identify horizontal/vertical/workflow authorization vulnerability candidates.

Output Deliverables

DeliverableDescription
API Endpoint InventoryTable: method, path, auth_required, roles_allowed, validation_summary, file:line
Network Interaction MapExternal services, internal services, exposed ports, subdomain inventory
Role & Privilege ArchitectureRole hierarchy, permission matrix, privilege escalation paths
Authorization Vulnerability CandidatesPrioritized list of endpoints with suspected authz gaps
Session ArchitectureToken type, storage, rotation, expiry, invalidation behavior

Tool Categories

CategoryToolsPurpose
Fingerprintingwhatweb, httpx, wappalyzerTechnology and framework identification
Network Reconnmap, subfinder, amassService discovery and subdomain enumeration
Web CrawlingPlaywright, katana, gospiderAuthenticated crawling and dynamic exploration
Content Discoveryffuf, feroxbusterHidden endpoint and directory discovery
Code Analysissemgrep, ripgrep, ast-grepRoute extraction and middleware tracing
Config Analysismanual reviewDeployment config correlation

References

  • references/tools.md - Tool function signatures and parameters
  • references/workflows.md - Reconnaissance workflow definitions and correlation procedures

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/jd-opensource/joysafeter/pentest-recon-attack-surface">View pentest-recon-attack-surface on skillZs</a>