Agent skill · Documentation

spec-to-code-compliance

Verifies code implements exactly what documentation specifies for blockchain audits. Use when comparing code against whitepapers, finding gaps between specs and implementation, or performing compliance checks for protocol implementations.

trailofbitsgithub.com/trailofbitsGitHub ↗
claude-codeCC-BY-SA-4.0
Install
npx skills add trailofbits/skills --skill spec-to-code-compliance --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 6
SKILL.md size: 10 KB
Bundled scripts: none
Path: plugins/spec-to-code-compliance/skills/spec-to-code-compliance/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 6,426
Language: Python
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

## When to Use Use this skill when you need to: - Verify code implements exactly what documentation specifies - Audit smart contracts against whitepapers or design documents - Find gaps between intended behavior and actual implementation - Identify undocumented code behavior or unimplemented spec claims - Perform compliance checks for blockchain protocol implementations **Concrete triggers:** - User provides both specification documents AND codebase - Questions like "does this code match the spec?" or "what's missing from the implementation?" - Audit engagements requiring spec-to-code alignment analysis - Protocol implementations being verified against whitepapers ## When NOT to Use Do NOT use this skill for: - Codebases without corresponding specification documents - General code review or vulnerability hunting (use audit-context-building instead) - Writing or improving documentation (this skill only verifies compliance) - Non-blockchain projects without formal specifications # Spec-to-Code Compliance Checker Skill You are the **Spec-to-Code Compliance Checker** — a senior-level blockchain auditor whose job is to determine whether a codebase implements **exactly** what the documen

What's inside
Steps it walks through
  1. When to Use
  2. When NOT to Use
  3. Rationalizations (Do Not Skip)
  4. (WITH TRUE LINE-BY-LINE / BLOCK-BY-BLOCK ANALYSIS)
  5. CRITICAL
  6. HIGH
  7. MEDIUM
  8. LOW
  9. Output Requirements & Quality Standards
  10. Completeness Verification
  11. Agent
Ships with 5 files
  • agents/openai.yaml
  • assets/trail-of-bits-mark.svg
  • resources/COMPLETENESS_CHECKLIST.md
  • resources/IR_EXAMPLES.md
  • resources/OUTPUT_REQUIREMENTS.md
More from skills
All skills →
About this skill
What does the spec-to-code-compliance skill do?

Verifies code implements exactly what documentation specifies for blockchain audits. Use when comparing code against whitepapers, finding gaps between specs and implementation, or performing compliance checks for protocol implementations.

How do I install it?

Run `npx skills add trailofbits/skills --skill spec-to-code-compliance --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From trailofbits/skills, a repository with 6,426 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going