shannon

Runs autonomous white-box penetration tests against web apps and APIs using Docker containers.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill shannon-lgj-jonathan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shannon
Source: https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills/tree/main/shannon
Command: npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill shannon-lgj-jonathan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Manual penetration testing is slow, expensive, and often produces unverified findings. This Skill orchestrates the Shannon framework to autonomously analyze source code, identify attack vectors, and execute real exploits that prove vulnerabilities before they reach production. ## Core Features & Use Cases - Autonomous Multi-Agent Pentesting: Runs a 5-phase pipeline (pre-recon, recon, vulnerability analysis, exploitation, reporting) with parallel agents covering Injection, XSS, SSRF, Broken Authentication, and Broken Authorization. - Proof-of-Concept Validation: Follows a "no exploit, no report" policy, so every reported finding includes a reproducible working exploit, minimizing false positives. - Safety Gates: Enforces authorization confirmation, warns against production targets, supports scope limits and avoid-rules for sensitive paths. - Use Case: Point the Skill at a local or staging app with its source code, and receive a full audit report with severity-ranked, exploitable vulnerabilities across 50+ OWASP test cases in about 1-1.5 hours. ## Quick Start Ask the assistant to run a Shannon pentest against your local app, for example by providing the target URL and source repo name such as http://localhost:3000 and myapp.

Frequently Asked Questions about shannon

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an automated pentest against my web app?

Invoke the shannon command with your target URL and source repo name, such as /shannon http://localhost:3000 myapp. The Skill confirms authorization, installs Shannon if needed, links your source code, and launches a full pentest across 5 OWASP categories.

What vulnerabilities does Shannon test for?

Shannon tests 50+ vulnerability types across 5 OWASP categories: SQL/command/NoSQL injection, reflected and stored XSS, SSRF including cloud metadata extraction, broken authentication (JWT flaws, MFA bypass), and broken authorization (IDOR, privilege escalation, path traversal).

What are the prerequisites for running Shannon?

You need Docker (or Podman), Git, and one AI credential: ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN, AWS Bedrock mode, or Google Vertex AI mode. Setting CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000 is recommended.

Can Shannon pentest an app running on localhost?

Yes, but since Shannon runs inside Docker, localhost must be translated to http://host.docker.internal:PORT. This works automatically on macOS and Windows with Docker Desktop; Linux may need the --add-host flag.

Is it safe to run Shannon against production systems?

No. Shannon executes real exploits with mutative effects and must never target production. The Skill enforces an authorization gate before every run and should only be used on systems you own or have explicit written permission to test.

How long does a Shannon pentest take and what does it cost?

A full pentest takes approximately 1 to 1.5 hours and costs around $50 using Claude Sonnet. You can monitor progress with the status command and stop it at any time with the stop command.