Skip to main content
skill CX Codex

shannon-ai-pentester — Claude Code skill: automated web app pentesting

A white-box pentester that reads your source, runs live exploits against a running app, and reports only findings it can reproduce.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add reason-machines/trending-skills --skill shannon-ai-pentester -a claude-code
Open on GitHub

What shannon-ai-pentester does

This skill brings Shannon, an autonomous pentester for web apps and APIs, into your project. It starts with recon through Nmap, Subfinder, WhatWeb and Schemathesis, then maps attack surfaces from the repository while parallel agents try exploits across categories: injection, XSS, SSRF, broken authentication and authorization. Each entry in the final report comes with a working proof of concept.

Everything runs in containers, so Docker is required. Model access comes from one of several sources: an Anthropic API key, a Claude OAuth token, AWS Bedrock, or Google Vertex AI, selected with SHANNON_AI_PROVIDER. For authenticated runs set TARGET_USERNAME, TARGET_PASSWORD and TARGET_TOTP_SECRET — Shannon handles 2FA on its own. Skip Docker or model credentials and nothing starts.

Results land in the workspace directory: report.md with severity, affected endpoint and reproduction steps, findings.json for tooling, plus per-agent logs. Long runs can be paused and picked up again by workspace name, and the workflow fits a CI job — the repository ships a GitHub Actions example.

What it helps with

  • check an API for SQL injection and auth bypass
  • get a report with reproducible PoCs instead of a list of guesses
  • run a pentest against staging before a release
  • test an app behind a login with two-factor enabled
  • add a security check to a CI pipeline

Example prompts for the agent

  • Scan my API for vulnerabilities and show me the report with PoCs
  • Set up Shannon for authenticated testing — TARGET_USERNAME and TARGET_TOTP_SECRET are already in the environment

How to install shannon-ai-pentester

1Skills CLI (Vercel)

npx skills add reason-machines/trending-skills --skill shannon-ai-pentester -a claude-code

2Manually: put the files in place

~/.claude/skills/shannon-ai-pentester/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/shannon-ai-pentester/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about shannon-ai-pentester

How do I install shannon-ai-pentester in Claude Code?

Run npx skills add reason-machines/trending-skills --skill shannon-ai-pentester -a claude-code. The skill lands at ~/.claude/skills/shannon-ai-pentester/SKILL.md.

What does shannon-ai-pentester do?

It reads your source code, finds attack vectors and executes real exploits against a live target. Only vulnerabilities with a working proof of concept make it into the report.

What does Shannon need to run?

Docker plus model access: an Anthropic API key, a Claude OAuth token, AWS Bedrock, or Google Vertex AI. Pick the provider with SHANNON_AI_PROVIDER.

Similar skills

All skills for Security →

From the same set139

daily-stock-analysis Automates stock analysis across US, Hong Kong, and Chinese markets using LLMs. It calculates entry targets, stop-losses, and delivers reports via chat webhooks. CX Codex +1 2,000installs ui-ux-pro-max-skill Describe a product to get a proposed page structure, visual style, palette, and font pairing. Use it to shape interface decisions before implementation. CX Codex +1 2,000installs everything-claude-code-harness The skill builds out an agent harness: subagents, slash commands, memory hooks and a security scan. Useful when every Claude session starts from a blank slate. CX Codex +1 1,800installs gstack-workflow-assistant A set of workflows for planning, code review, releases, and browser QA. Call the workflow you need with a slash command. CX Codex +1 1,700installs autoresearchclaw-autonomous-research A skill that wires up AutoResearchClaw, a 23-stage pipeline turning one topic string into a paper with verified citations and experiment code. CX Codex +1 1,600installs deepseek-ocr Teaches your coding agent to run DeepSeek-OCR for document parsing and markdown extraction. Works with images and PDFs via vLLM or Transformers. CX Codex +1 1,600installs paperclip-ai-orchestration Teaches coding assistants to manage Paperclip, an open-source platform that runs autonomous AI agents with org charts, task tickets, and budget caps. CX Codex +1 1,500installs marketingskills-ai-agents Connect an AI coding agent to marketing skills for SEO, copy, analytics, and conversion work. Start by giving the agent shared context about your product. CX Codex +1 1,500installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor