X api pentest
Use when the user provides an OpenAPI or Swagger spec and asks to find security issues, pentest the API, audit endpoints for OWASP API Top 10, or check for BOLA, BFLA, mass assignment, injection, or SSRF vulnerabilities in a running HTTP APIFrom its SKILL.md
npx -y skills add quangtran88/x-skills --skill x-api-pentestAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
7.2 KB, as published. Nobody here has run it
x-api-pentest — API Security Pentest from OpenAPI/Swagger
Black-box dynamic security testing of a live HTTP API using its OpenAPI/Swagger spec as the attack surface map. Orchestrates Schemathesis, RESTler, Nuclei, sqlmap, and interactsh, with Claude reasoning over findings to catch business-logic flaws.
Bootstrap
MANDATORY first step — do this BEFORE anything else:
0. Pin capabilities for the session per ../x-shared/capability-loading.md. Use the security_tools block (schemathesis, nuclei, sqlmap, spectral, interactsh) to skip lanes whose CLIs are unavailable rather than failing mid-step.
- Read
config.jsonto load tool paths, default flags, safety gates (safety.require_target_confirmation,safety.allowed_target_patterns,safety.denied_target_patterns, rate caps, per-oracle toggles). - Read
gotchas.md— known failure patterns and the Noise Filters section (patterns that must NOT be emitted as findings). - Read
references/safe-execution.md— target allowlist, sandboxing, credential isolation. - Confirm explicit authorization. If
safety.require_target_confirmationis true, ASK: "Confirm you are authorized to test<target_url>. Type the URL to proceed." - Memory recall (only when
mcp.basic_memorypinned in the bootstrap-active set): onemcp__basic-memory__search_notes({ query: "<target host/API name> api vulnerabilities", page_size: 5 })call — keep the query purely topical per § Memory Reflex (no skill-name or repo-name tokens) — surface prior confirmed vuln classes / target gotchas / noise-filter lessons as leads for oracle reasoning, not verdicts, per../x-shared/mcp-toolbox.md § Memory Reflex. Skip silently when not pinned.
Safe Execution Environment
This skill issues live HTTP requests including blind re-verification of each finding. Unsandboxed against the wrong target = production incident. Before proceeding:
- Target must match
safety.allowed_target_patterns(localhost, RFC1918,*.staging.*,*.test.*,*.local). Override requiresallow_unsafe_target=true+ user confirmation. - Prefer an egress-isolated container (Docker Compose with
internal: true,cap_drop: ALL,no-new-privileges). Template inreferences/safe-execution.md. - Credentials only via environment variables. Never read tokens from committed files.
Scope
DOES: dynamic black-box testing, OWASP API Top 10 (2023), BOLA / BFLA / mass assignment / SSRF / injection / rate-limit / business logic, markdown + SARIF output.
DOES NOT: static code review (→ ck-security, code-review), secret/dependency scanning (→ security-scan), network/infra pentest, social engineering, unauthorized testing.
How this differs from existing skills
- vs Transience
api-security— Transience is bug-bounty / recon-driven. This skill is OpenAPI/Swagger-spec driven — hand it a spec, it systematically pentests every documented endpoint. - vs HexStrike AI MCP — HexStrike is the tool execution layer (~150 wrapped CLIs). This skill is the orchestration layer and calls HexStrike when
config.integrations.prefer_hexstrike: true, else direct CLI. - vs Pwnkit — Pwnkit is general-purpose autonomous pentesting. This skill is API-only and dev-loop oriented. The blind-verification pattern in step 4 is borrowed from Pwnkit.
- vs OWASP Claude Skill — that skill is reference-only documentation. This skill actively tests.
See references/related-skills.md for full comparison.
Step-File Architecture
This skill uses sequential steps. Load ONE step file at a time. Complete each before proceeding.
Critical Rules
- Load ONE step file at a time — multiple causes phase merging and skipped checkpoints.
- Read the entire step file before acting — partial reads miss the gate at the bottom.
- Follow steps in order — step 4 requires step 2 credentials; step 5 requires step 3+4 outputs.
- Halt at every checkpoint for human input — auto-proceeding past consent gates is a security failure, not productivity.
- No active scans without explicit target confirmation — the consent gate at the end of step 1 is non-negotiable.
Workflow
steps/step-01-recon.md— spec lint, attack surface, role mapping, consent gatesteps/step-02-auth-baseline.md— validate 2 user tokens + admin tokensteps/step-03-automated-sweep.md— parallel Schemathesis + RESTler (opt-in) + Nucleisteps/step-04-targeted-tests.md— BOLA/BFLA, mass assignment, SSRF, velocity, business logic, LLM injectionsteps/step-05-synthesize.md— dedupe, severity, chain-impact reasoningsteps/step-06-report.md— markdown + SARIF, handoff
Start with step 1 now.
Severity
This skill extends the canonical x-skills severity scale (../x-shared/severity-guide.md — CRITICAL / HIGH / MEDIUM / LOW) with an additional Info tier for non-actionable findings (informational / advisory only — never blocks merge). Casing follows CVSS-lite convention (Title-case: Critical / High / Medium / Low / Info) inside this skill's outputs because findings flow into SARIF (references/sarif-schema.md) and CVSS reporting tools that expect Title-case labels. When findings cross over into a generic x-skills review pipeline, map: Title-case → UPPER-case, Info → LOW.
Detail: references/owasp-api-top10-2023.md.
References
Loaded ONLY when needed by a step:
references/owasp-api-top10-2023.md— risk catalog with detection oraclesreferences/tool-invocations.md— exact CLI invocations with auth handlingreferences/auth-recipes.md— OAuth2/JWT/API-key/refresh patternsreferences/bola-bfla-playbook.md— two-user matrix algorithmreferences/sarif-schema.md— SARIF 2.1.0 output formatreferences/related-skills.md— when to use this vs Transience / HexStrike / Pwnkit / OWASPreferences/safe-execution.md— target allowlist, sandboxing, creds (read during bootstrap)references/llm-injection-patterns.md— Oracle G payload library (loaded by step-04 only if LLM endpoints detected)
Dependencies
- External tools — schemathesis, nuclei, sqlmap, spectral, interactsh-client (docker optional for RESTler). Step 1 fails fast with install instructions.
- superpowers:verification-before-completion — every Critical/High finding needs a curl repro before claiming complete.
Red Flags — STOP and reconsider
- Active scans without explicit target confirmation
- Target not matching
safety.allowed_target_patternswithoutallow_unsafe_target=true - Skipping step 2 (BOLA needs 2 users)
- "No findings" without showing tool exit codes
- Treating tool outputs independently — must dedupe + chain
- Output without curl reproductions
- Raising sqlmap risk above default (1) without explicit approval
- Hitting
*.gov/*.milor any denied pattern - Emitting findings matching Noise Filters in
gotchas.md
Gotchas
See gotchas.md — update when you encounter new ones.
Task: {{ARGUMENTS}}