claude-bughunter

Un ensemble de compétences Claude autonome pour la chasse aux bugs et le travail de red team externe · 82 compétences · 15 commandes slash · 681 modèles de rapports divulgués couvrant 24 classes de vulnérabilités principales · matrices d'attaque identité d'entreprise + infrastructure · génération de structure de dossiers d'engagement · intégration Burp MCP · éprouvé lors d'engagements autorisés de red team et de chasse aux bugs, ainsi que sur des plateformes d'entraînement publiques (DVWA, OWASP Juice Shop, Hacker101, testphp.vulnweb.com).

Développé par Sachin Sharma — Recherche en sécurité Bug Hunting & GenAI.

_{SPONSORISÉ PAR}

Qu'est-ce que c'est ?

claude-bughunter est un ensemble de compétences prêt à l'emploi pour le système de compétences Claude Code. Installez-le une fois et Claude Code cesse d'être un chatbot pour se comporter comme un chercheur senior en chasse de bugs ou un opérateur red team : il connaît les techniques, les modèles de chaînes d'attaque, les correspondances VRT, les chaînes CVE des plateformes et les règles d'hygiène — et il reste dans le périmètre.

Quatre couches se superposent :

• Think — bb-methodology + redteam-mindset : le flux de travail non linéaire en 5 phases, le cadre de pensée critique et la discipline d'opérateur red team.
• Hunt webapps — 48 compétences hunt-* tirées de 681 rapports HackerOne divulgués : modèles de détection par classe, payloads, tableaux de bypass et modèles de chaînes d'attaque.
• Hit the perimeter — chaînes d'attaque des plateformes d'entreprise (M365/Entra, Okta, vCenter, appliances SSL-VPN, SharePoint, IAM cloud) : chaînes CVE 2024–2026 actuelles + escalade après compromission d'identifiants.
• Ship it — triage-validation + reporting + evidence-hygiene : la validation en 7 questions, la sévérité tenant compte du VRT, les réfutations hors-périmètre, le masquage des PII et les livrables red team.

Tout est déclenché automatiquement par sujet — décrivez ce que vous testez en langage simple et la compétence pertinente se charge. Aucune invocation par nom.

Démarrage rapide

Option A — installation en tant que plugin Claude Code (recommandée). Depuis Claude Code :

/plugin marketplace add elementalsouls/Claude-BugHunter
/plugin install claude-bughunter@elementalsouls

Les 82 compétences + 15 commandes se chargent dans l'espace de noms claude-bughunter: et se mettent à jour lorsque vous augmentez la version du plugin — aucun fichier copié dans ~/.claude/.

Option B — installation par copie (sans système de plugin / épinglage à un clone) :

git clone https://github.com/elementalsouls/Claude-BugHunter.git
cd Claude-BugHunter

# macOS / Linux
bash scripts/install.sh

# Windows (PowerShell)
pwsh ./scripts/install.ps1

Les deux copient les compétences + commandes dans ~/.claude/ (macOS/Linux) ou %USERPROFILE%\.claude\ (Windows) et branchent le générateur de structure d'engagement hunt.

Ce que chaque méthode d'installation vous apporte :

Le plugin est le chemin le plus rapide vers les compétences + commandes slash. L'exécuteur cbh natif du terminal s'installe de manière autonome — pipx install git+https://github.com/elementalsouls/Claude-BugHunter — afin que les utilisateurs du plugin puissent l'ajouter sans clone complet (voir CLI cbh). Le générateur de structure d'engagement hunt est fourni avec le clone (Option B).

Et voilà. Ouvrez Claude Code et décrivez ce que vous testez en langage simple — la bonne compétence se charge automatiquement, sans invocation par nom :

> Testing acme.com — an in-scope HackerOne target. Run recon and rank the surface.

  ⟳ loading skills: web2-recon, offensive-osint, bb-methodology …
    → subdomain enum (subfinder + crt.sh) … 47 hosts
    → live hosts (httpx) … 12 · tech fingerprint … 6 distinct stacks
    → ranked surface: api.acme.com (GraphQL, introspection ON)  ← start here
                      auth.acme.com (OAuth, SSO)               ← hunt-oauth

  Next: want me to probe the GraphQL introspection + OAuth redirect_uri?

→ Guide d'installation complet · Guide d'utilisation · catalogue de compétences consultable.

Le bloc ci-dessus est une transcription illustrative. Pour enregistrer une véritable démo de votre propre session : asciinema rec demo.cast → téléversez-la sur asciinema.org et placez le badge ici.

Fonctionne sur quatre environnements d'exécution

Les compétences sont de simples Agent Skills — le même format SKILL.md que Claude Code · OpenCode · OpenAI Codex CLI · Hermes Agent chargent tous. Une seule commande les installe partout :

# macOS / Linux
bash scripts/install.sh --all --burp-mcp

# Windows (PowerShell)
pwsh ./scripts/install.ps1 -All -BurpMcp

--all (-All) copie les compétences vers le chemin de chaque environnement (~/.claude/skills, ~/.agents/skills, ~/.hermes/skills) ; --burp-mcp (-BurpMcp) branche le serveur Burp MCP dans chacun d'eux. La couche de connaissances complète est portée sur les quatre — les commandes slash et le moteur /hunt restent exclusifs à Claude Code par conception.

→ Guide multi-environnements

Historique des étoiles

Périmètre — à quoi sert cet ensemble, et à quoi il ne sert pas

Cet ensemble couvre la surface d'attaque externe — tout ce qui est accessible depuis Internet sans compromettre au préalable un point de terminaison interne.

Dans le périmètre

• Chasse aux bugs (bug bounty) — applications web, API, SaaS, GraphQL, OAuth, JWT, upload de fichiers, IDOR, SSRF, chaînes RCE
• Tests d'intrusion d'applications web — couverture complète hunt-* des classes de bugs mappées OWASP + règles de discipline
• Engagements red team externes — accès initial contre le parc d'entreprise exposé à Internet : M365 / Entra ID, Okta comme IdP, SharePoint sur site (ToolShell + SOAP hérité), VMware vCenter / Workspace ONE, appliances SSL VPN (Cisco / Fortinet / Citrix / Palo Alto / Pulse / SonicWall / F5), red team d'APK Android, reconnaissance supply chain
• Mauvaise configuration cloud + escalade après compromission d'identifiants — S3 publics, chaînes IMDS, STS AssumeRole, confused-deputy inter-comptes
• Recon + OSINT — énumération de sous-domaines, cartographie de la trame d'identité, transparence des certificats, analyse JS, détection de secrets
• Rapports — H1, Bugcrowd (tenant compte du VRT), Intigriti, Immunefi, plus le format de livrable red team destiné aux clients

Hors périmètre (délibéré — pas des lacunes, des choix de conception)

• Attaques Active Directory internes — BloodHound, Kerberoasting, ASREProast, DCSync, Pass-the-Hash, abus AD CS, ntlmrelayx, Responder, PetitPotam, etc. Profil de risque opérationnel différent ; nécessite des outils et un jugement différents. Un futur ensemble, pas celui-ci.
• Frameworks C2 — Cobalt Strike, Sliver, Mythic, Havoc, techniques BRC4. Hors périmètre pour un modèle d'engagement exclusivement externe.
• Post-exploitation / persistance / mouvement latéral — dump LSASS via Mimikatz/comsvcs, tickets golden/silver, usurpation de named-pipe, persistance (registre, tâches planifiées, événements WMI, détournement COM), vol de jetons. Ces techniques commencent une fois le périmètre déjà franchi — un autre territoire d'ensemble.
• Évasion — contournement AMSI, patching ETW, contournement AV/EDR. Lié aux techniques C2 ci-dessus.
• Pentest iOS / matériel / RF / ICS — hors périmètre par conception.
• Exploitation binaire / pwn de noyau / internes des navigateurs — un univers de compétences différent.

Si vous opérez une red team interne qui inclut des chaînes de prise de contrôle de domaine via Kerberos ou du mouvement latéral, cet ensemble ne vous aidera pas dans ces phases — et nous préférons le dire d'emblée plutôt que de vous laisser le découvrir en plein engagement. Le transfert de la surface externe vers les outils de red team interne (Impacket, NetExec, CrackMapExec, Rubeus, Certify, BloodHound) est intentionnellement hors de notre périmètre. La couverture de l'AD interne et de la post-exploitation pourrait arriver dans une future mise à jour.

Contenu

82 compétences, chargées automatiquement par sujet — aucune invocation par nom. Couverture de la surface d'attaque externe :

Catalogue complet et consultable → docs/skills.md. Fournit également 15 commandes slash (/hunt, /recon, /report, …) et un moteur d'engagement déterministe (engine/) qui cartographie la surface d'attaque d'une cible et achemine chaque découverte vers la compétence qui la traite.

Comment ça fonctionne

Un flux de travail non linéaire en 6 phases — recon → map & rank → hunt → validate → report — avec le périmètre appliqué dans le code et une validation en 7 questions avant toute soumission. Deux façons de le piloter :

• Langage simple — décrivez ce que vous testez et la compétence pertinente se charge automatiquement.
• Générateur /hunt + CLI cbh — structure des dossiers d'engagement, état et orchestration.

→ Guide d'utilisation & exemple complet · Architecture en 6 phases & correspondance compétence-phase · CLI cbh

Autorisation

Ces compétences sont destinées aux actifs que vous possédez ou pour lesquels vous disposez d'une autorisation écrite d'audit (actifs dans le périmètre d'un programme de bug bounty, lettres de mission de pentest, défis CTF, votre propre infrastructure).

Les compétences incluent des validations qui se déclenchent automatiquement lorsque vous pointez Claude vers des cibles tierces non vérifiées — la validation en 7 questions de triage-validation demande explicitement si l'actif est dans le périmètre (Q3) et sur la liste des impacts acceptés du programme (Q2). La compétence bugcrowd-reporting inclut une hygiène côté chercheur (alias Bugcrowdninja, restauration de l'état du compte, posture de testeur amical) qui signale un test légitime et autorisé à l'équipe anti-fraude de la cible.

L'ensemble exclut explicitement : l'armement de 0-day contre des cibles non autorisées, les outils de post-exploitation, le développement de malwares, l'infrastructure de ciblage de masse. Voir SECURITY.md pour la posture complète.

Attention — garde-fous cyber d'exécution Anthropic. Les modèles d'Anthropic appliquent des garde-fous en temps réel qui bloquent par défaut « l'exploitation de vulnérabilités ou le développement d'outils de sécurité offensive » — de sorte que même un travail autorisé et dans le périmètre peut se heurter à un refus qui n'est pas le fait de cet ensemble. Si vous pratiquez la sécurité offensive autorisée (pentest / bug bounty / red team), inscrivez-vous au programme gratuit, sur candidature, Cyber Verification Program (CVP) d'Anthropic pour que les garde-fous soient ajustés au travail légitime à double usage. (L'exfiltration massive de données et le développement de ransomwares restent interdits et ne sont pas ajustables.) Détails : Anthropic — garde-fous cyber en temps réel.

Documentation

Pourquoi cet ensemble existe

La plupart des configurations Claude pour la chasse aux bugs sont soit trop génériques (une seule grosse invite « sécurité »), soit trop fragmentées (vous mettez en favori 30 rapports divulgués et les relisez à chaque engagement). Aucune des deux ne passe à l'échelle au-delà de la deuxième cible.

Cet ensemble a été conçu et validé lors d'engagements autorisés qui ont mis en évidence différents manques de capacités :

Engagement bug bounty — a mis en évidence quatre manques qu'une stack de démarrage à 3 compétences ne pouvait pas combler :

1. Pas de discipline d'hypothèse — des brouillons rédigés avant validation → des heures perdues, un ratio de validité dégradé
2. Pas de tactiques de rapport par programme — les valeurs par défaut du VRT ont automatiquement rétrogradé des découvertes dignes de P3 en P4
3. Pas de coordination d'engagement — découvertes, preuves et identifiants de soumission dispersés dans les dossiers
4. Pas d'hygiène des preuves — des captures d'écran ont divulgué des cookies et des PII de victimes

Engagement red team externe — a exposé cinq manques supplémentaires que les défauts du bug bounty aggravaient :

1. Des valeurs par défaut prudentes ont rétracté de vraies découvertes — l'état d'esprit WAPT a arrêté les tests prématurément sur des cibles défendues où la poursuite en red team aurait fait remonter des chaînes de contournement → redteam-mindset
2. Pas de connaissance de la situation en cours d'engagement — le SOC du client a corrigé une SQLi confirmée en 30 minutes ; un attaquant externe a verrouillé 14 comptes pendant une session de test en direct — les deux invisibles sans méthodologie de détection explicite → mid-engagement-ir-detection
3. Pas de chaînes d'attaque de plateformes d'entreprise — M365 + Entra ID, SharePoint sur site, Cisco SSL VPN, vCenter et 7 APK Android nécessitaient tous des connaissances CVE 2024-2026 à jour et des techniques spécifiques aux plateformes → m365-entra-attack, okta-attack, hunt-sharepoint, hunt-aspnet, hunt-ntlm-info, vmware-vcenter-attack, enterprise-vpn-attack, apk-redteam-pipeline
4. Pas de format de livrable destiné au client — les modèles de rapport de bug bounty ne conviennent pas à la red team d'entreprise dont le livrable est un MD + DOCX de plus de 50 Ko avec captures d'écran intégrées →

Les compétences hunt-* par classe comblent l'écart zéro (« que dois-je chercher dans les applications web ») — les 24 d'origine codifiant des modèles issus de 681 rapports HackerOne divulgués, avec plus de 20 compétences framework/surface ajoutées par l'expansion communautaire v3 — Claude connaît les véritables modèles de chaînes d'attaque qui ont été rémunérés par les vrais triagers, et non le Top 10 OWASP abstrait. Les couches plateformes d'entreprise et techniques red team répondent à ce que le bug bounty seul ne peut pas : les engagements red team externes contre des cibles d'entreprise surveillées.

Feuille de route

• Intégration MCP HackerOne (actuellement seul Burp MCP est branché)
• Couche de mémoire par engagement — rappel des modèles entre les cibles
• Compétences hunt spécifiques aux secteurs — hunt-fintech-graphql, hunt-healthcare-fhir, hunt-gov-compliance
• Compétence d'analyse des règles de programme — génération automatique d'un scope.md structuré à partir du texte du programme
• Actualiser les compétences hunt-* avec des rapports divulgués plus récents (relancer public-skills-builder)
• Compétences supplémentaires pour plateformes d'entreprise — citrix-netscaler-deep, f5-bigip-attack, (AD Certificate Services)

Sponsors

Atlas Cloud est une plateforme d'inférence IA full-modal qui offre aux développeurs une API IA unique pour accéder aux API de génération vidéo, de génération d'images et de LLM. Au lieu de gérer plusieurs intégrations de fournisseurs, vous vous connectez une seule fois et obtenez un accès unifié à plus de 300 modèles sélectionnés, toutes modalités confondues.

Découvrez la nouvelle promotion du coding plan d'Atlas Cloud pour un accès API plus économique : https://www.atlascloud.ai/console/coding-plan

À propos

Des techniques opérationnelles accumulées lors d'engagements de bug bounty et de pentests autorisés, codifiées en compétences Claude. Indépendant de la plateforme — à intégrer dans n'importe quel flux de travail d'engagement que vous utilisez déjà, ou aucun.

Auteur : ElementalSoul · Recherche en sécurité GenAI

Projet frère : Claude-OSINT — des compétences appariées pour la phase de recon, sur lesquelles cet ensemble enchaîne ensuite. Ses deux compétences de recon (offensive-osint, osint-methodology) sont maintenues canoniquement ici et ré-exportées là-bas, de sorte que les deux sont identiques octet pour octet. Installer les deux est sans risque : l'installateur de chaque ensemble (install.sh sur macOS/Linux, install.ps1 sur Windows) enregistre un manifeste, le script saute la re-copie d'une compétence identique, et --uninstall conserve toute compétence que l'autre ensemble possède encore — désinstaller l'un ne casse jamais l'autre.

Fondation intégrée (vendored) : shuvonsec/claude-bug-bounty — méthodologie, validation, rapports, bibliothèque de payloads (8 des 82 compétences + 15 commandes slash)

Outil générateur utilisé (non vendored) : shuvonsec/public-skills-builder — utilisé pour générer des compétences par classe à partir des rapports divulgués H1

Inspirations :

• archangel / douglasday — chasseur du top 10 H1 ; modèle de compétence par classe
• Trail of Bits — trailofbits/skills — discipline de création de compétences
• SecSkills — trilwu/secskills — modèle de sous-agent

Inventaire d'outils :

• PortSwigger Burp Suite + extension MCP Server
• ProjectDiscovery — subfinder · dnsx · httpx · katana · nuclei
• SecLists · Assetnote Wordlists

Licence : MIT — utilisation libre, attribution appréciée.

« Donnez à Claude la bonne compétence et il cesse d'être un chatbot. Il devient un opérateur. »