hunt-xss · h-mmer — Claude Code skill for XSS hunting: setup and what it does
hunt-xss — a skill for Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, and Windsurf that teaches the agent to find XSS vulnerabilities — DOM-based, stored, reflected, mXSS, and newer variants.
no license ★ 1,298 updated 2026-06-12
npx skills add H-mmer/pentest-agents --skill hunt-xss -a claude-codeWhat hunt-xss does
Once installed, the agent gains structured knowledge across six target classes: DOMPurify mXSS bypasses (CVE-2024-47875, CVE-2024-45801, GHSA-h8r8-wccr-v5f2), OAuth redirect_uri and returnTo flaws (CVE-2025-67716 in Auth0 Next.js SDK before 4.13.0), stored XSS chains that reach admin account takeover (GHSA-jmr4-p576-v565, CVSS 8.0), postMessage handlers with broken origin checks, markdown renderer injections (CVE-2024-21535 in markdown-to-jsx before 7.4.0), and RSC payload injections (CVE-2025-67779, CVE-2025-55184).
The knowledge base covers specific researcher techniques: @kinugawamasato's deep-nesting mXSS variant that triggers across Firefox, Chromium, and Safari together; @hash_kitten's full bypass without nesting; @ryotkak's XML-based bypass. Sources include HackerOne, Intigriti, Bugcrowd, Huntr, GitHub Security Advisories, and Cure53 advisories.
Code using react-server-dom-webpack with React 19.0.0–19.2.0 (before the 19.0.2/19.1.3/19.2.2 patches) is a priority surface the skill targets first. Node.js is required; install via npx skills add.
What it helps with
- find DOMPurify nesting or re-contextualization bypasses in library consumers
- audit an OAuth flow for reflected XSS via
redirect_uri,returnTo, orstateparameters - trace a stored XSS path from low-privilege content to an admin session
- detect postMessage handlers where origin is checked with
.includes()instead of strict equality - check a markdown renderer or RSC payload for injection through
dangerouslySetInnerHTML
Example prompts for the agent
- Check this component for mXSS via DOMPurify re-contextualization
- Find every
addEventListener('message', ...)in the codebase and test the origin check for bypass - Audit the OAuth flow for XSS through the
returnToparameter using the CVE-2025-67716 pattern
How to install hunt-xss
1Skills CLI (Vercel)
npx skills add H-mmer/pentest-agents --skill hunt-xss -a claude-code2Manually: put the files in place
~/.claude/skills/pentest-agents-hunt-xss/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/pentest-agents-hunt-xss/
1Skills CLI (Vercel)
npx skills add H-mmer/pentest-agents --skill hunt-xss -a codex2Manually: put the files in place
.agents/skills/pentest-agents-hunt-xss/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add H-mmer/pentest-agents --skill hunt-xss -a cursor2Manually: put the files in place
.cursor/skills/pentest-agents-hunt-xss/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install H-mmer/pentest-agents providers/cursor/.cursor/skills/pentest-agents-hunt-xss2Manually: put the files in place
.github/skills/pentest-agents-hunt-xss/SKILL.md1Skills CLI (Vercel)
npx skills add H-mmer/pentest-agents --skill hunt-xss -a gemini-cli2Platform CLI
gemini skills install https://github.com/H-mmer/pentest-agents --path providers/cursor/.cursor/skills/pentest-agents-hunt-xssManually: put the files in place
.devin/skills/pentest-agents-hunt-xss/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about hunt-xss
How do I install hunt-xss in Claude Code?
Run npx skills add H-mmer/pentest-agents --skill pentest-agents-hunt-xss -a claude-code. The skill file will then be available at ~/.claude/skills/pentest-agents-hunt-xss/SKILL.md.
What does the hunt-xss skill do?
It loads a curated XSS knowledge base into the agent's context — 1500 bug bounty reports and NVD-verified CVEs from 2024 to 2026 — so the agent can reason about DOM-based, stored, reflected, mXSS, and other XSS patterns in your code.
Which platforms does hunt-xss support?
Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, and Windsurf (Devin Desktop). Each platform has its own install path via npx skills add or gh skill install.
Similar skills
All skills for Security →hunt-xss by other authors comes first.