| name | repo-agent-instructions |
|---|---|
| description | Top-level guidance for agents using starknet-skills modules. |
This repository contains Cairo/Starknet skills for AI coding agents. Each skill is a prescriptive orchestrator — it tells you exactly what to load, what to check, and in what order.
| Skill | Use when | Entry point |
|---|---|---|
| cairo-auditor | Security review of Cairo contracts | cairo-auditor/SKILL.md |
| cairo-contract-authoring | Writing new contracts or modifying existing ones | cairo-contract-authoring/SKILL.md |
| cairo-testing | Writing unit, integration, fuzz, or regression tests | cairo-testing/SKILL.md |
| cairo-optimization | Profiling and optimizing gas/steps | cairo-optimization/SKILL.md |
| cairo-toolchain | Build, declare, deploy, verify operations | cairo-toolchain/SKILL.md |
| account-abstraction | Account abstraction patterns and risks | account-abstraction/SKILL.md |
| starknet-network-facts | Starknet network constraints and semantics | starknet-network-facts/SKILL.md |
For new contract work, use this sequence:
cairo-contract-authoring— write the contractcairo-testing— add testscairo-optimization— optimize hot paths (if needed)cairo-auditor— security review
Each SKILL.md file contains:
- When to Use / When NOT to Use — scope boundaries
- Quick Start — 5-step summary
- Orchestration — turn-by-turn instructions with exact tool calls
- Security-Critical Rules — non-negotiable constraints
- References — links to detailed reference material
Read the SKILL.md for the task at hand. Follow its orchestration steps. Load references only when the orchestration tells you to — this keeps context focused.
- Scarb: >= 2.14.0 (recommended 2.16.x)
- Starknet Foundry (snforge/sncast): 0.57.0
- OpenZeppelin Cairo: 3.0.0
- Cairo edition: 2024_07