MCPInstall

wooyun-legacy

Provides web vulnerability testing methodology distilled from 88,636 real-world cases from the WooYun vulnerability database (2010-2016). Use when performing penetration testing, security audits, code reviews for security flaws, or vulnerability research. Covers SQL injection, XSS, command execution, file upload, path traversal, unauthorized access, information disclosure, and business logic flaws.

Installs
105
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/trailofbits/skills-curated --skill wooyun-legacy
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads wooyun-legacy automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

WooYun Vulnerability Analysis Knowledge Base

Methodology and testing patterns extracted from 88,636 real-world vulnerability cases reported to the WooYun platform (2010-2016).


When to Use

All testing described here must be performed only against systems you have written authorization to test.

  • Penetration testing web applications
  • Security code review (server-side or client-side)
  • Vulnerability research against web targets you have explicit authorization to test
  • Building security test cases or checklists
  • Assessing web application attack surface
  • Reviewing remediation effectiveness
  • Training or education in authorized security testing contexts

When NOT to Use

  • Network infrastructure testing (firewalls, routers, switches)
  • Mobile application binary analysis
  • Malware analysis or reverse engineering
  • Compliance-only assessments (PCI-DSS, SOC2 checklists without testing)
  • Physical security assessments
  • Social engineering campaigns
  • Cloud infrastructure misconfigurations (IAM, S3 buckets) — these require cloud-specific tooling, not web vuln patterns

Rationalizations to Reject

These shortcuts lead to missed findings. Reject them:

  • "The WAF will catch it" — WAFs are bypass-able; test the application logic, not the middleware
  • "It's an internal app, so auth doesn't matter" — internal apps get compromised via SSRF, lateral movement, and credential reuse
  • "We already use parameterized queries everywhere" — check for ORM misuse, stored procedures with dynamic SQL, and second-order injection
  • "The framework handles XSS" — template engines have raw output modes, JavaScript contexts bypass HTML encoding, and DOM XSS lives entirely client-side
  • "File uploads are safe because we check the extension" — extension checks are bypassed via null bytes, double extensions, parser discrepancies, and race conditions
  • "We validate on the frontend" — client-side validation is a UX feature, not a security control
  • "Nobody would guess that URL" — security through obscurity fails against directory bruteforcing, referrer leaks, and JS source analysis
  • "Low severity, not worth reporting" — low-severity findings chain into critical attack paths

Core Mental Model

Vulnerability = Expected Behavior - Actual Behavior
             = Developer Assumptions + Attacker Input -> Unexpected State

Analysis chain:
1. Where does data come from?  (Input sources)
   -> GET/POST/Cookie/Header/File/WebSocket
2. Where does data flow?       (Data path)
   -> Validation -> Processing -> Storage -> Output
3. Where is data trusted?      (Trust boundaries)
   -> Client / Server / Database / OS / External service
4. How is data processed?      (Processing logic)
   -> Filter / Escape / Validate / Execute
5. Where does data end up?     (Output sinks)
   -> HTML / SQL / Shell / Filesystem / Log / Email

Attack Surface Mapping

              +-------------------------------------------+
              |         Application Attack Surface         |
              +-------------------------------------------+
                                  |
          +-----------------------+-----------------------+
          |                       |                       |
     +----v----+            +-----v-----+           +-----v-----+
     |  Input  |            | Processing|           |  Output   |
     +---------+            +-----------+           +-----------+
     | GET     |            | Input     |           | HTML page |
     | POST    |    ->      | validation|    ->     | JSON resp |
     | Cookie  |            | Biz logic |           | File DL   |
     | Headers |            | DB query  |           | Error msg |
     | File    |            | File op   |           | Log entry |
     | Upload  |            | Sys call  |           | Email     |
     +---------+            +-----------+           +-----------+

SQL Injection

Cases: 27,732 | Reference: sql-injection.md | Checklist: sql-injection-checklist.md

High-risk parameters: id, sort_id, username, password, search, keyword, page, order, cat_id

Injection point detection:

  • String terminators: ' " ) ') ") -- # /*
  • DB fingerprint: @@version (MSSQL), version() (MySQL), v$version (Oracle)

Bypass techniques:

  • Whitespace: /**/ %09 %0a ()
  • Keywords: SeLeCt sel%00ect /*!select*/
  • Equals: LIKE REGEXP BETWEEN IN
  • Quotes: 0x hex, char(), concat()

Core defense: parameterized queries (PreparedStatement / ORM binding).


Cross-Site Scripting (XSS)

Cases: 7,532 | Reference: xss.md | Checklist: xss-checklist.md

Output points: user profile fields (nickname, bio), search reflections, file metadata (filename, alt text), email content (subject, body)

Bypass techniques:

  • Tag mutation: <ScRiPt> <script/x> <script\n>
  • Event handlers: onerror onload onmouseover onfocus
  • Encoding: HTML entities, JS Unicode, URL encoding
  • Protocol handlers: javascript: data: vbscript:

Core defense: context-aware output encoding + Content Security Policy.


Command Execution

Cases: 6,826 | Reference: command-execution.md | Checklist: command-execution-checklist.md

Entry points: system command wrappers (ping, traceroute, nslookup), file operations (compress, decompress, image processing), code eval (eval, assert, preg_replace(/e)), framework vulnerabilities (Struts2, WebLogic, JBoss)

Command chaining:

  • Linux: ; | || && \ $()`
  • Windows: & | || &&

Bypass techniques:

  • Whitespace: ${IFS} $IFS$9 %09 < <>
  • Keywords: ca\t ca''t c$@at /???/??t
  • Encoding: $(printf "\x63\x61\x74"), `echo Y2F0|base64 -d`

Core defense: avoid shell invocation; use execFile over exec, allowlist acceptable inputs.


File Upload

Cases: 2,711 | Reference: file-upload.md | Checklist: file-upload-checklist.md

Bypass detection:

  • Client-side validation: modify JS or send request directly
  • Content-Type: image/gif header + PHP code body
  • Extension: .php5 .phtml .pht .php. .php::$DATA
  • Content inspection: GIF89a + <?php or image-based webshell
  • Parser discrepancy: /upload/1.asp;.jpg (IIS 6.0)

Parser-specific vulnerabilities:

  • IIS 6.0: /test.asp/1.jpg, test.asp;.jpg
  • Apache: .php.xxx (unknown extension fallback)
  • Nginx: /1.jpg/1.php (cgi.fix_pathinfo)
  • Tomcat: test.jsp%00.jpg

Core defense: allowlist extensions, rename uploads, store outside webroot, validate content type server-side.


Path Traversal

Cases: 2,854 | Reference: path-traversal.md | Checklist: path-traversal-checklist.md

High-risk parameters: file, path, filename, url, dir, template, page, include, download

Traversal payloads:

  • Basic: ../../../etc/passwd
  • Encoded: %2e%2e%2f, ..%252f, %c0%ae%c0%ae/
  • Null byte: ../../../etc/passwd%00.jpg
  • Windows: ..\..\..\windows\win.ini

Target files (Linux): /etc/passwd, /etc/shadow, /proc/self/environ, /var/log/apache2/access.log

Core defense: resolve canonical paths, validate against allowlisted directories, never use user input in file paths directly.


Unauthorized Access

Cases: 14,377 | Reference: unauthorized-access.md | Checklist: unauthorized-access-checklist.md

Access types:

  • Admin panel exposure: /admin, /manager, /console
  • API without authentication: missing token validation, predictable tokens
  • Exposed services: Redis (6379), MongoDB (27017), Elasticsearch (9200), Memcached (11211), Docker (2375)
  • IDOR: horizontal privilege escalation via ID enumeration

Core defense: authentication + authorization on every endpoint, session management, principle of least privilege.


Information Disclosure

Cases: 7,337 | Reference: info-disclosure.md | Checklist: info-disclosure-checklist.md

Disclosure sources: error messages with stack traces, exposed .git or .svn directories, backup files (.bak, .sql, .tar.gz), configuration files, debug endpoints, directory listings

Core defense: custom error pages, disable directory listing, remove debug endpoints in production, audit publicly accessible files.


Business Logic Flaws

Cases: 8,292 | Reference: logic-flaws.md | Checklist: logic-flaws-checklist.md

Vulnerability patterns:

  • Password reset: verification code in response body, step skipping, controllable reset tokens
  • Authorization bypass: horizontal (ID enumeration), vertical (role escalation)
  • Payment logic: amount tampering, quantity manipulation, coupon stacking
  • CAPTCHA: not refreshed, reusable, brute-forceable, client-side only

Testing approach:

  1. Map the business flow -> draw state transition diagram
  2. Identify critical checks -> which parameters determine outcomes
  3. Attempt bypass -> modify parameters / skip steps / replay / race
  4. Verify impact -> prove the scope of harm

Core defense: server-side validation of all business-critical logic.


Additional Categories

These categories are derived from case data without full reference documents. Each has a testing checklist extracted from real cases.

CategoryChecklist
CSRFcsrf-checklist.md
SSRFssrf-checklist.md
Weak Passwordsweak-password-checklist.md
Misconfigurationmisconfig-checklist.md
Remote Code Executionrce-checklist.md
XML External Entity (XXE)xxe-checklist.md

Note: The RCE checklist covers deserialization, OGNL injection, and framework-specific remote code execution — distinct from the OS command injection focus of the Command Execution reference above.


Methodology Case Studies

Real-world penetration testing methodology examples (anonymized):

Case StudyDescription
bank-penetration.mdMulti-stage attack chain against a financial institution
telecom-penetration.mdInfrastructure penetration of a telecom carrier

These demonstrate how individual vulnerabilities chain together into full compromise scenarios.


Testing Priority Framework

High Priority (test first)

  1. SQL Injection — direct data access, highest case count (27,732)
  2. Command Execution — OS-level compromise
  3. File Upload — arbitrary code execution via webshell

Medium Priority

  1. Unauthorized Access — second-highest case count (14,377)
  2. Business Logic Flaws — application-specific, hard to automate
  3. XSS — session hijacking, phishing

Lower Priority (but still important)

  1. Path Traversal — file read, sometimes write
  2. Information Disclosure — reconnaissance value, enables chaining
  3. CSRF/SSRF/XXE — context-dependent severity

Defense Quick Reference

VulnerabilityCore DefenseImplementation
SQL InjectionParameterized queriesPreparedStatement / ORM
XSSOutput encodingContext-aware escaping + CSP
Command ExecutionAvoid shellexecFile not exec, allowlist
File UploadStrict validationAllowlist ext, rename, isolate
Path TraversalCanonical pathsResolve + validate against allowlist
Unauthorized AccessAccess controlAuthN + AuthZ + session mgmt
Logic FlawsServer-side checksValidate all business logic server-side
Info DisclosureMinimize exposureCustom errors, no debug in prod

Key Insight

All 88,636 vulnerabilities in this database share a common root cause: the gap between what developers assumed and what attackers actually provided. Effective security testing means systematically challenging every assumption at every trust boundary.

Four principles from the data:

  1. Boundary thinking — all vulnerabilities occur at trust boundaries
  2. Data flow tracing — follow data from input to output completely
  3. Assumption challenging — question every "obvious" validation
  4. Chain composition — individual low-severity findings combine into critical attack paths

FAQ

What does the wooyun-legacy skill do?

Provides web vulnerability testing methodology distilled from 88,636 real-world cases from the WooYun vulnerability database (2010-2016). Use when performing penetration testing, security audits, code reviews for security flaws, or vulnerability research. Covers SQL injection, XSS, command execution, file upload, path traversal, unauthorized access, information disclosure, and business logic flaws.

How do I install wooyun-legacy?

Run npx skills add https://github.com/trailofbits/skills-curated --skill wooyun-legacy in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/wooyun-legacy/ (personal) or .claude/skills/wooyun-legacy/ (project).

Which AI agents can use wooyun-legacy?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is wooyun-legacy safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains wooyun-legacy?

It is published by trailofbits in trailofbits/skills-curated. It has 105 recorded installs.

More from trailofbits/skills-curated

View all →

ghidra-headless

trailofbits/skills-curated

Reverse engineers binaries using Ghidra's headless analyzer. Use when decompiling executables, extracting functions, strings, symbols, or analyzing call graphs from compiled binaries without the Ghidra GUI.

510 installs

humanizer

trailofbits/skills-curated

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases. 30c5c8d (Update humanizer plugin to upstream v2.2.0)

Docs & Writing207 installs

skill-extractor

trailofbits/skills-curated

Extracts reusable skills from work sessions. Use when: (1) a non-obvious problem was solved worth preserving, (2) a pattern was discovered that would help future sessions, (3) a workaround or debugging technique needs documentation. Manual invocation only via /skill-extractor command - no automatic triggers or hooks.

openai-develop-web-game

trailofbits/skills-curated

Use when the agent is building or iterating on a web game (HTML/JS) and needs a reliable development + testing loop: implement small changes, run a Playwright-based test script with short input bursts and intentional pauses, inspect screenshots/text, and review console errors with rendergametotext. Originally from OpenAI's curated skills catalog.

Media & Creative134 installs

planning-with-files

trailofbits/skills-curated

Implements file-based planning for complex multi-step tasks. Creates taskplan.md, findings.md, and progress.md as persistent working memory. Use when starting tasks requiring 5 tool calls, multi-phase projects, research, or any work where losing track of goals and progress would be costly.

security-awareness

trailofbits/skills-curated

Teaches agents to recognize and avoid security threats during normal activity. Covers phishing detection, credential protection, domain verification, and social engineering defense. Use when building or operating agents that access email, credential vaults, web browsers, or sensitive data.

Security125 installs

Popular security skills

View category →

azure-compliance

microsoft/azure-skills

Run Azure compliance and security audits with azqr plus Key Vault expiration checks. Covers best-practice assessment, resource review, policy/compliance validation, and security posture checks. WHEN: compliance scan, security audit, BEFORE running azqr (compliance cli tool), Azure best practices, Key Vault expiration check, expired certificates, expiring secrets, orphaned resources, compliance assessment.

OfficialSecurity567K installs

minimal-run-and-audit

lllllllama/rigorpilot-skills

Rigor Run skill for README-first deep learning repo reproduction. Use when the task is specifically to capture or normalize evidence from the selected smoke test or documented inference or evaluation command and write standardized reprooutputs/ files, including patch notes when repository files changed. Do not use for training execution, initial repo intake, generic environment setup, paper lookup, target selection, hidden scientific-meaning changes, or end-to-end orchestration by itself.

Security477.4K installs

seo-audit

coreyhaines31/marketingskills

When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tags review," "SEO health check," "my traffic dropped," "lost rankings," "not showing up in Google," "site isn't ranking," "Google update hit me," "page speed," "core web vitals," "crawl errors," "indexing issues," "stuck on page 2," "striking distance keywords," "title tag rewrite," "low CTR," "local SEO," "Google Business Profile," or "map pack." Use this even if the user just says something vague like "my SEO is bad" or "help with SEO" — start with an audit. For building pages at scale to target keywords, see programmatic-seo. For adding structured data, see schema. For AI search optimization, see ai-seo.

Security238.7K installs

firebase-security-rules-auditor

firebase/agent-skills

Audits Firebase (Firestore, Cloud Storage) security rules for vulnerabilities, privilege escalation, role bypasses, create vs update inconsistencies, resource exhaustion, type safety, size limits, and hasOnly ownership checks. Use when auditing/reviewing rules, running red-team rule assessments, or scoring against auditor checklists. Don't use for Firebase CLI (login, deploy), Auth, Crashlytics, Remote Config, or database queries.

OfficialSecurity139.1K installs

audit

pbakaus/impeccable

Run technical quality checks across accessibility, performance, theming, responsive design, and anti-patterns. Generates a scored report with P0-P3 severity ratings and actionable plan. Use when the user wants an accessibility check, performance audit, or technical quality review.

Security81.9K installs

competitors

coreyhaines31/marketingskills

When the user wants to create competitor comparison or alternative pages for SEO and buyer-facing use. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'competitor teardown,' 'audit our competitor pages,' 'are our comparison pages out of date,' or 'competitive asset audit.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. For auditing existing claims (not researching competitors from scratch, which is competitor-profiling; not technical SEO on these pages, which is seo-audit), use the asset audit here. For internal battle cards and sales-specific competitor docs, see sales-enablement.

Security79.3K installs