/ Directory / Playground / Trail of Bits Skills
● Community trailofbits ⚡ Instant

Trail of Bits Skills

by trailofbits · trailofbits/skills

Trail of Bits' Claude Code skills for security code review, vulnerability detection, and defensive audit workflows.

The security firm Trail of Bits packaged their internal code-review playbooks as Claude Code skills. Coverage includes common-weakness detection across languages, crypto mistake catching, input-validation review, and IaC misconfig checks. CC-BY-SA-4.0 — free to use and adapt.

Why use it

Key features

Live Demo

What it looks like in practice

ready

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "trailofbits-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/trailofbits/skills",
        "~/.claude/skills/skills"
      ],
      "_inferred": true
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "trailofbits-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/trailofbits/skills",
        "~/.claude/skills/skills"
      ],
      "_inferred": true
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "trailofbits-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/trailofbits/skills",
        "~/.claude/skills/skills"
      ],
      "_inferred": true
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "trailofbits-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/trailofbits/skills",
        "~/.claude/skills/skills"
      ],
      "_inferred": true
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "trailofbits-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/trailofbits/skills",
        "~/.claude/skills/skills"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json
{
  "context_servers": {
    "trailofbits-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/trailofbits/skills",
          "~/.claude/skills/skills"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add trailofbits-skill -- git clone https://github.com/trailofbits/skills ~/.claude/skills/skills

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use Trail of Bits Skills

Add a security-review pass to every PR

👤 Teams without a dedicated security engineer ⏱ ~30 min intermediate

When to use: Your PRs currently go straight from code-review to merge — no security eyes.

Prerequisites
  • Skills installed — git clone https://github.com/trailofbits/skills ~/.claude/skills/trailofbits
Flow
  1. Scope the diff
    Use trailofbits/pr-review skill on the current PR. List files the skill thinks are security-relevant with reasons.✓ Copied
    → Concrete file-by-file relevance reasons
  2. Deep review
    For each flagged file, run the appropriate domain skill (crypto, input-validation, auth). Report findings with severity.✓ Copied
    → Severity-ranked list with code refs
  3. Summary for reviewer
    Write a 5-bullet PR comment summarizing the findings, non-scary but precise.✓ Copied
    → Reviewer-friendly summary with exact line citations

Outcome: A security review comment on every PR that catches real issues without drowning you in false positives.

Pitfalls
  • Skill flags style issues as security — Calibrate by prompting: "focus on exploitable issues only"
Combine with: github · filesystem

Audit cryptographic code paths in a service

👤 Devs maintaining auth/encryption code ⏱ ~90 min advanced

When to use: You have a JWT/HMAC/encryption layer and want someone smart to double-check.

Flow
  1. Find crypto
    Use trailofbits/crypto-review. Scan /src for files that touch crypto APIs. Report them.✓ Copied
    → Crypto call-site inventory
  2. Audit each
    For each site: what algorithm? Key management? Nonce reuse risk? IV handling? Cite source.✓ Copied
    → Per-site audit with code refs
  3. Remediation plan
    For any medium+ finding, draft a remediation — concrete code change, not "consider using ...".✓ Copied
    → Applicable diffs, not vague advice

Outcome: A crypto audit report with concrete fixes, from a baseline of common mistakes ToB has seen in real engagements.

Pitfalls
  • Not a substitute for a real audit — Use for self-review; hire professionals before launch of high-value surfaces
Combine with: github

Combinations

Pair with other MCPs for X10 leverage

trailofbits-skill + github

Post findings as a PR review comment

Post the review as a PR comment — severities as labels.✓ Copied
trailofbits-skill + filesystem

Scan the whole repo offline

Run the full security sweep across /src and write report to /audit/report.md.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
scope_review diff|path Before deep dive 0
crypto_review path Crypto code specifically 0
input_validation_review path API/boundary code 0
iac_review path Terraform / CloudFormation / K8s manifests 0

Cost & Limits

What this costs to run

API quota
N/A
Tokens per call
Review is reading-heavy; budget proportional to diff size
Monetary
Free (CC-BY-SA)
Tip
Scope first — don't run deep skills on irrelevant files

Security

Permissions, secrets, blast radius

Minimum scopes: filesystem-read
Credential storage: None
Data egress: None from skill; reviewed code is in your LLM context
Never grant: write access unless auto-remediating

Troubleshooting

Common errors and fixes

Skill flags safe code as vulnerable

Ask for rationale; if weak, dismiss with reason. Calibration improves over sessions.

Misses obvious bugs

The skill codifies Trail of Bits' patterns — if your stack is unusual (e.g. niche Rust crate), it may miss. Add custom patterns.

Outputs too long to review

Constrain: "top 5 highest-severity findings only"

Alternatives

Trail of Bits Skills vs others

AlternativeWhen to use it insteadTradeoff
Semgrep rulesYou want static analysis in CI, not interactive reviewNarrower pattern set; no LLM reasoning
CodeQLYou want deep dataflow analysisMuch more setup; not a skill

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills