guidelines-advisor — Claude Code skill: what it does, how to install
Audits smart contract codebases against Trail of Bits guidelines. It spots upgradeability pitfalls, flawed inheritance, and testing gaps.
npx skills add trailofbits/skills --skill guidelines-advisor -a claude-codeWhat guidelines-advisor does
This skill audits smart contract codebases using Trail of Bits guidelines from the Building Secure Contracts framework. It guides the agent through five clear stages, progressing from project discovery to plain-English specifications and prioritized remediation steps.
The assessment covers eleven distinct areas. It examines on-chain and off-chain workload distribution, contract upgradeability, and storage layout safety under delegatecall proxies. For Solidity code, it checks NatSpec coverage, flags compiler warnings, and inspects inheritance hierarchies.
Generating visual architectural diagrams requires Slither installed locally. All final action items come grouped by severity, from critical blockers down to minor code improvements.
What it helps with
- audit delegatecall proxies and upgradeability patterns
- identify missing NatSpec tags and specification gaps
- evaluate contract inheritance depth and function composition
- spot weaknesses in test suite coverage and fuzzing setup
Example prompts for the agent
- Review this smart contract codebase against Trail of Bits development guidelines.
- Audit our upgradeable proxy pattern and verify storage layout safety.
- Draft a plain English system description and check NatSpec completeness.
How to install guidelines-advisor
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill guidelines-advisor -a claude-code2Manually: put the files in place
~/.claude/skills/guidelines-advisor/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/guidelines-advisor/
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill guidelines-advisor -a codex2Manually: put the files in place
.agents/skills/guidelines-advisor/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill guidelines-advisor -a cursor2Manually: put the files in place
.cursor/skills/guidelines-advisor/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install trailofbits/skills guidelines-advisor2Manually: put the files in place
.github/skills/guidelines-advisor/SKILL.md1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill guidelines-advisor -a gemini-cli2Platform CLI
gemini skills install https://github.com/trailofbits/skills --path plugins/building-secure-contracts/skills/guidelines-advisorManually: put the files in place
.devin/skills/guidelines-advisor/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add trailofbits/skills --skill guidelines-advisor -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set35
The whole set →Similar
Questions about guidelines-advisor
How to install guidelines-advisor in Claude Code?
Run npx skills add trailofbits/skills --skill guidelines-advisor -a claude-code in your terminal.
What does guidelines-advisor do?
The skill audits smart contracts across eleven areas, including delegatecall safety, inheritance trees, event emission, and dependencies.
How are the findings prioritized?
The skill assigns every finding to one of four priority levels: CRITICAL, HIGH, MEDIUM, or LOW.