starknet-agentic-skills

Starknet Agentic

┌──────────────────────────────────────────────────────────────┐
│ starknet-agentic                                            │
│ contracts • runtimes • skills for policy-enforced agents    │
└──────────────────────────────────────────────────────────────┘

Infrastructure for the Starknet agent economy: contracts, runtimes, and skills to run self-custodial AI agents with on-chain identity, policy-enforced execution, and composable tool access.

Why This Exists

Most agent stacks treat wallets as add-ons. starknet-agentic treats wallets, identity, and execution policy as first-class system boundaries.

This repo gives you:

• account-level control rails (session keys, spending policy, revoke paths)
• ERC-8004 identity, reputation, and validation registries on Starknet
• MCP and A2A integration packages for agent runtimes
• reusable skills and end-to-end examples

Fastest Path

If you just want Starknet agent capabilities now:

npx create-starknet-agent@latest

Sanity check (npm availability):

npm view create-starknet-agent version

The scaffolder detects your environment (OpenClaw/MoltBook, Claude Code, Cursor, or standalone) and wires Starknet integration automatically.

Install & Use

Use the path that matches your runtime:

# Full project scaffold
npx create-starknet-agent@latest

# Codex (built-in installer, cairo-auditor)
CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
python3 "$CODEX_HOME/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
  --repo keep-starknet-strange/starknet-agentic \
  --path skills/cairo-auditor \
  --ref main
# Restart Codex, then run /skills and invoke cairo-auditor

# Codex (frozen install)
# Replace <commit-sha> with the exact immutable revision you want to pin.
CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
python3 "$CODEX_HOME/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
  --repo keep-starknet-strange/starknet-agentic \
  --path skills/cairo-auditor \
  --ref <commit-sha>

# Claude Code marketplace
/plugin marketplace add keep-starknet-strange/starknet-agentic
/plugin install starknet-agentic-skills@starknet-agentic-skills --scope user
/reload-plugins
/plugin menu
/starknet-agentic-skills:cairo-auditor

# Individual skill install via Agent Skills CLI
npx skills add keep-starknet-strange/starknet-agentic/skills/cairo-auditor

For deterministic install/usage guidance, see:

• skills/QUICKSTART_2MIN.md
• skills/TROUBLESHOOTING.md
• docs/CLAUDE_MARKETPLACE_SUBMISSION.md

For the full skill catalog and Cairo migration notes, see skills/README.md and docs/CAIRO_SKILLS_MIGRATION.md.

Flagship Skills

Skill	Best for	Fast path
cairo-auditor	Pre-merge Cairo security review with deterministic preflight and false-positive gating	30-second quickstart
starknet-wallet	Wallet ops, transfers, session keys, paymaster flows	Skill docs
starknet-defi	Swaps, DCA, staking, lending, AVNU routing	Skill docs
starknet-identity	ERC-8004 registration, reputation, validation	Skill docs

System Requirements

• CLI users (npx create-starknet-agent@latest): Node.js >=18.0.0
• Contributors from source (this monorepo):
  • Node.js >=20.9.0
  • pnpm >=10.28.2 (workspace package manager)
  • Scarb >=2.14.0 + Starknet Foundry (snforge) >=0.54.1 (for Cairo builds/tests)

Choose Your Path

Goal	Start here
Add Starknet tools to an existing agent	packages/create-starknet-agent
Run local no-backend onboarding demo	examples/onboard-agent
Run autonomous loop with MCP tools	examples/full-stack-swarm
Integrate on-chain identity/reputation	contracts/erc8004-cairo
Build production signer boundary	packages/starknet-mcp-server + external signer (proxy mode)

Architecture