Back to Skills

shannon

Autonomous AI pentester for web apps and APIs. Run white-box security assessments with Shannon — analyzes source code, identifies attack vectors, and executes real exploits to prove vulnerabilities. Triggered by 'shannon', 'pentest', 'security audit', 'vuln scan'.

39stars5forksUpdated 5/28/2026

Security Assessment

Low Risk(70/100)

Detected risks:

Secret Exposure([SKILL.md] AWS_ACCESS_KEY, [SKILL.md] API_KEY=, [SKILL.md] TOKEN=)
Security Score70/100

About shannon

Shannon is an autonomous AI-powered pentesting skill designed for web applications and APIs. It helps security engineers and developers identify and validate vulnerabilities before deployment by combining source code analysis with active exploit execution. The skill orchestrates a Docker-based security testing workflow that analyzes application code, maps potential attack vectors, and performs real exploit attempts to confirm the presence of vulnerabilities. Shannon is intended for white-box security assessments and is specifically designed to run only against systems that users own or have explicit authorization to test.

The skill supports testing for multiple OWASP Top 10 vulnerability categories, including injection flaws, cross-site scripting (XSS), server-side request forgery (SSRF), broken authentication, and broken authorization. It can perform full pentests or targeted scans focused on selected categories. Shannon also supports named workspaces for resumable assessments, configurable scopes, and custom YAML-based configurations for advanced authentication flows or testing rules. The workflow includes mandatory safety validation steps, environment checks, and authorization confirmation before any pentest execution begins. The tool relies on Docker and Git, and requires environment configuration such as an API key for operation.

Shannon is intended for application security engineers, penetration testers, developers, DevSecOps teams, and organizations conducting internal security assessments in local, staging, or sandboxed environments. Typical use cases include validating security controls during development, testing APIs before release, running security audits against staging systems, and reproducing exploit scenarios in controlled environments. Because the tool executes real attacks with mutative effects, it is explicitly not intended for production systems or unauthorized targets.

FAQ

What types of vulnerabilities can Shannon test for?

Shannon supports testing for multiple OWASP Top 10 categories, including injection vulnerabilities, XSS, SSRF, broken authentication, and broken authorization.

Can Shannon run targeted security scans instead of a full pentest?

Yes. The skill supports scoped testing for specific categories such as xss, injection, ssrf, auth, and authz in addition to full pentests.

What environments are supported for testing?

Shannon is intended for local, staging, or sandboxed environments. The documentation explicitly warns against running tests against production systems.

What dependencies or requirements does Shannon have?

Shannon requires Docker and Git, along with environment configuration such as ANTHROPIC_API_KEY. Optional environment variables are also supported for alternative runtime integrations.

Does Shannon require authorization before running a pentest?

Yes. The workflow requires explicit confirmation that the user owns the target system or has written authorization to perform pentesting before any testing begins.

All Files

5 files
README.md6.9 KB
View
SKILL.md14.5 KB
View
scripts/setup-shannon.sh1.9 KB
View
CLAUDE.md0.6 KB
View
scripts/sync.sh0.6 KB
View

Install shannon

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill