trailofbits/guidelines-advisor

Conseiller de développement de contrats intelligents basé sur les meilleures pratiques de Trail of Bits. Analyse la base de code pour générer de la documentation/spécifications, examiner l'architecture, vérifier les modèles de mise à niveau, évaluer la qualité de l'implémentation, identifier les pièges, examiner les dépendances et évaluer les tests. Fournit des recommandations exploitables.

Qu'est-ce que guidelines-advisor ?

Le skill `trailofbits/guidelines-advisor` est un assistant de développement de contrats intelligents qui intègre les bonnes pratiques de l'entreprise de cybersécurité Trail of Bits. Il analyse la base de code d'un projet Solidity (ou autres langages EVM) pour générer une documentation technique et des spécifications claires, examiner l'architecture globale (modularité, niveau de confiance, flux de données), vérifier les modèles de mise à niveau (comme les proxies), évaluer la qualité de l'implémentation (conformité aux normes OpenZeppelin, bon usage des variables d'état), identifier les pièges courants (dépendances non vérifiées, variables d'état exposées, problèmes de gestion des accès), examiner les dépendances (recherche de versions avec des vulnérabilités connues), et évaluer la couverture des tests unitaires et d'intégration. Le skill ne remplace pas un audit de sécurité complet, mais fournit des recommandations exploitables pour améliorer la robustesse, la sécurité et la maintenabilité du code. Il est conçu pour être utilisé avec des agents comme Claude Code, Cursor ou Codex, en lisant les fichiers du projet et en produisant des rapports structurés. Il est particulièrement utile pour les développeurs qui souhaitent appliquer des standards de sécurité élevés dès la phase de conception.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/trailofbits/skills/tree/main/skills/guidelines-advisor

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait guidelines-advisor ?

Conseiller de développement de contrats intelligents basé sur les meilleures pratiques de Trail of Bits. Analyse la base de code pour générer de la documentation/spécifications, examiner l'architecture, vérifier les modèles de mise à niveau, évaluer la qualité de l'implémentation, identifier les pièges, examiner les dépendances et évaluer les tests. Fournit des recommandations exploitables.

Vue d'ensemble

Ce skill aide les développeurs de contrats intelligents à appliquer les meilleures pratiques de sécurité et de développement de Trail of Bits. Il analyse le code pour identifier les problèmes courants et suggérer des améliorations.

Fonctionnalités

  • Documentation et spécifications : Génère une documentation technique exhaustive, y compris des diagrammes d'architecture, des descriptions de flux de données et des spécifications d'interface.
  • Examen de l'architecture : Évalue la modularité, la séparation des préoccupations, les niveaux de confiance et la gestion des dépendances.
  • Vérification des modèles de mise à niveau : Analyse l'utilisation des modèles de proxy (UUPS, transparent), vérifie les slots de stockage et les fonctions d'initialisation.
  • Évaluation de l'implémentation : Vérifie la conformité aux normes OpenZeppelin, le bon usage des variables d'état, la visibilité appropriée des fonctions et la gestion des erreurs.
  • Identification des pièges : Repère les dépendances non vérifiées, les variables d'état exposées, les problèmes de gestion des accès et les vulnérabilités courantes.
  • Examen des dépendances : Recherche des versions obsolètes ou vulnérables dans les dépendances.
  • Évaluation des tests : Analyse la couverture des tests unitaires et d'intégration, suggère des cas de test manquants.

Utilisation

Pour utiliser ce skill, assurez-vous que votre projet est accessible à l'agent et exécutez une commande telle que :

# Exemple pour analyser le projet
guidelines-advisor analyze --path ./contracts

Ou bien, fournissez simplement le chemin de votre projet à l'agent.

Exemple de sortie

## Rapport d'analyse

### Documentation
- Génération de diagrammes d'architecture...
- Spécifications d'interface...

### Recommandations
1. Utiliser des modèles de proxy pour les mises à niveau.
2. Vérifier les dépendances pour des vulnérabilités connues.
3. Ajouter des tests pour les cas limites.

Remarques

  • Ce skill ne remplace pas un audit de sécurité professionnel.
  • Les recommandations sont basées sur des bonnes pratiques générales et peuvent nécessiter une adaptation au contexte du projet.

Références

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

trailofbits/address-sanitizer

AddressSanitizer detects memory errors during fuzzing. Use when fuzzing C/C++ code to find buffer overflows and use-after-free bugs.

trailofbits/aflpp

AFL++ is a fork of AFL with better fuzzing performance and advanced features. Use for multi-core fuzzing of C/C++ projects.

trailofbits/agentic-actions-auditor

Audits GitHub Actions workflows for security vulnerabilities in AI agent integrations including Claude Code Action, Gemini CLI, OpenAI Codex, and GitHub AI Inference. Detects attack vectors where attacker-controlled input reaches AI agents running in CI/CD pipelines, including env var intermediary patterns, direct expression injection, dangerous sandbox configurations, and wildcard user allowlists. Use when reviewing workflow files that invoke AI coding agents, auditing CI/CD pipeline security for prompt injection risks, or evaluating agentic action configurations.

trailofbits/algorand-vulnerability-scanner

Scans Algorand smart contracts for 11 common vulnerabilities including rekeying attacks, unchecked transaction fees, missing field validations, and access control issues. Use when auditing Algorand projects (TEAL/PyTeal).

trailofbits/ask-questions-if-underspecified

Clarify requirements before implementing. Use when serious doubts arise.

trailofbits/atheris

Atheris is a coverage-guided Python fuzzer based on libFuzzer. Use for fuzzing pure Python code and Python C extensions.

trailofbits/audit-augmentation

Augments Trailmark code graphs with external audit findings from SARIF static analysis results and weAudit annotation files. Maps findings to graph nodes by file and line overlap, creates severity-based subgraphs, and enables cross-referencing findings with pre-analysis data (blast radius, taint, etc.). Use when projecting SARIF results onto a code graph, overlaying weAudit annotations, cross-referencing Semgrep or CodeQL findings with call graph data, or visualizing audit findings in the context of code structure.

trailofbits/audit-context-building

Enables ultra-granular, line-by-line code analysis to build deep architectural context before vulnerability or bug finding.

trailofbits/audit-prep-assistant

Prepares codebases for security review using Trail of Bits' checklist. Helps set review goals, runs static analysis tools, increases test coverage, removes dead code, ensures accessibility, and generates documentation (flowcharts, user stories, inline comments).

trailofbits/burpsuite-project-parser

Searches and explores Burp Suite project files (.burp) from the command line. Use when searching response headers or bodies with regex patterns, extracting security audit findings, dumping proxy history or site map data, or analyzing HTTP traffic captured in a Burp project.

trailofbits/cairo-vulnerability-scanner

Scans Cairo/StarkNet smart contracts for 6 critical vulnerabilities including felt252 arithmetic overflow, L1-L2 messaging issues, address conversion problems, and signature replay. Use when auditing StarkNet projects.

trailofbits/cargo-fuzz

cargo-fuzz is the de facto fuzzing tool for Rust projects using Cargo. Use for fuzzing Rust code with libFuzzer backend.

trailofbits/chrome-mcp-troubleshooting

Diagnose and fix Claude in Chrome MCP extension connectivity issues. Use when mcp__claude-in-chrome__* tools fail, return "Browser extension is not connected", or behave erratically.

trailofbits/claude-in-chrome-troubleshooting

Diagnose and fix Claude in Chrome MCP extension connectivity issues. Use when mcp__claude-in-chrome__* tools fail, return "Browser extension is not connected", or behave erratically.

trailofbits/code-improver

Runs an autonomous review-and-fix improvement loop over any code target — a skill, plugin, module, or directory — using a reviewer the user names: any installed skill or agent. Keeps a cross-round findings ledger, escalates when fixes stop converging, and guards scope mechanically. Use when asked to 'improve this code until review passes', 'run an improvement loop with <reviewer>', or to iterate review-and-fix with a specific reviewer. For skills prefer the skill-improver entry; for a branch prefer pr-improver.

trailofbits/code-maturity-assessor

Systematic code maturity assessment using Trail of Bits' 9-category framework. Analyzes codebase for arithmetic safety, auditing practices, access controls, complexity, decentralization, documentation, MEV risks, low-level code, and testing. Produces professional scorecard with evidence-based ratings and actionable recommendations.

trailofbits/codeql

Scans a codebase for security vulnerabilities using CodeQL's interprocedural data flow and taint tracking analysis. Triggers on "run codeql", "codeql scan", "codeql analysis", "build codeql database", or "find vulnerabilities with codeql". Supports "run all" (security-and-quality + security-experimental suites) and "important only" (high-precision security findings) scan modes. Also handles creating data extension models and processing CodeQL SARIF output.

trailofbits/constant-time-analysis

Detects timing side-channel vulnerabilities in cryptographic code. Use when implementing or reviewing crypto code, encountering division on secrets, secret-dependent branches, or constant-time programming questions in C, C++, Go, Rust, Swift, Java, Kotlin, C#, PHP, JavaScript, TypeScript, Python, or Ruby.

trailofbits/constant-time-testing

Constant-time testing detects timing side channels in cryptographic code. Use when auditing crypto implementations for timing vulnerabilities.

trailofbits/cosmos-vulnerability-scanner

Scans Cosmos SDK blockchain modules and CosmWasm contracts for consensus-critical vulnerabilities — chain halts, fund loss, state divergence. 25 core + 16 IBC + 10 EVM + 3 CosmWasm patterns. Use when auditing custom x/ modules, reviewing IBC integrations, or assessing pre-launch chain security. Updated for SDK v0.53.x.

Skills associés