starknet-agentic
bykeep-starknet-strange· 19 skills
Routes Starknet agent, wallet, DeFi, identity, SDK, and Cairo contract work to the smallest focused skill module.
How to install starknet-agentic?
keep-starknet-strange/starknet-agentic
$npx -y skills add keep-starknet-strange/starknet-agentic --skill starknet-agenticInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Run `npx skills use "https://github.com/keep-starknet-strange/starknet-agentic" --skill "keep-starknet-strange/starknet-agentic"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.
Use the skills in "https://github.com/keep-starknet-strange/starknet-agentic" that are relevant to the current task. Run `npx skills add "https://github.com/keep-starknet-strange/starknet-agentic"` and select the relevant skills, then follow their instructions.
SKILL.md
| 1 | # Starknet Agentic |
| 2 | |
| 3 | [](https://github.com/keep-starknet-strange/starknet-agentic/actions/workflows/ci.yml) |
| 4 | [](https://github.com/keep-starknet-strange/starknet-agentic/actions/workflows/codeql.yml) |
| 5 | [](./LICENSE) |
| 6 | |
| 7 | Production-grade Starknet agent infrastructure: secure Cairo contracts, MCP/A2A runtimes, x402 payment helpers, end-to-end examples, and installable agent skills. |
| 8 | |
| 9 | This repository is for developers building agents that need Starknet-native wallets, policy-enforced execution, on-chain identity, and composable tool access. |
| 10 | |
| 11 | ## Install & Use |
| 12 | |
| 13 | ### Scaffold a Starknet agent |
| 14 | |
| 15 | ```bash |
| 16 | npx @starknetfoundation/create-starknet-agent@latest |
| 17 | ``` |
| 18 | |
| 19 | The scaffolder detects supported agent environments and wires Starknet integration into a new project. |
| 20 | |
| 21 | ### Install a skill |
| 22 | |
| 23 | ```bash |
| 24 | npx skills add keep-starknet-strange/starknet-agentic/skills/cairo-auditor |
| 25 | ``` |
| 26 | |
| 27 | Codex public GitHub install: |
| 28 | |
| 29 | ```bash |
| 30 | CODEX_HOME="${CODEX_HOME:-$HOME/.codex}" |
| 31 | python3 "$CODEX_HOME/skills/.system/skill-installer/scripts/install-skill-from-github.py" \ |
| 32 | --repo keep-starknet-strange/starknet-agentic \ |
| 33 | --path skills/cairo-auditor \ |
| 34 | --ref main |
| 35 | ``` |
| 36 | |
| 37 | Codex reproducible install: |
| 38 | |
| 39 | ```bash |
| 40 | CODEX_HOME="${CODEX_HOME:-$HOME/.codex}" |
| 41 | python3 "$CODEX_HOME/skills/.system/skill-installer/scripts/install-skill-from-github.py" \ |
| 42 | --repo keep-starknet-strange/starknet-agentic \ |
| 43 | --path skills/cairo-auditor \ |
| 44 | --ref <commit-sha> |
| 45 | ``` |
| 46 | |
| 47 | Claude Code marketplace install: |
| 48 | |
| 49 | ```bash |
| 50 | /plugin marketplace add keep-starknet-strange/starknet-agentic |
| 51 | /plugin install starknet-agentic-skills@starknet-agentic-skills --scope user |
| 52 | ``` |
| 53 | |
| 54 | For Codex, Claude Code, and pinned install flows, use the deterministic skill quickstart: |
| 55 | |
| 56 | - [`skills/QUICKSTART_2MIN.md`](./skills/QUICKSTART_2MIN.md) |
| 57 | - [`skills/README.md`](./skills/README.md) |
| 58 | - [`skills/TROUBLESHOOTING.md`](./skills/TROUBLESHOOTING.md) |
| 59 | |
| 60 | ### Run the MCP server from source |
| 61 | |
| 62 | From a source checkout after `pnpm install`: |
| 63 | |
| 64 | ```bash |
| 65 | pnpm --filter @starknetfoundation/starknet-agentic-mcp-server build |
| 66 | node packages/starknet-mcp-server/dist/index.js |
| 67 | ``` |
| 68 | |
| 69 | Production deployments should use proxy signer mode rather than in-process private keys. See [`packages/starknet-mcp-server`](./packages/starknet-mcp-server/) and [`docs/security/SIGNER_API_SPEC.md`](./docs/security/SIGNER_API_SPEC.md). |
| 70 | |
| 71 | ## What Is Included |
| 72 | |
| 73 | | Area | Path | Purpose | |
| 74 | |---|---|---| |
| 75 | | Cairo contracts | [`contracts/`](./contracts/) | Agent accounts, ERC-8004 registries, session-account primitives, and registry experiments | |
| 76 | | TypeScript packages | [`packages/`](./packages/) | CLI scaffolder, MCP server, A2A adapter, agent passport helpers, onboarding utilities, prediction scanner, and x402 helpers | |
| 77 | | Skills | [`skills/`](./skills/) | Public agent skills for Cairo auditing, Starknet wallets, DeFi, identity, testing, deployment, optimization, and SDK usage | |
| 78 | | Examples | [`examples/`](./examples/) | Reference agent flows covering onboarding, identity, MCP loops, DeFi, carry monitoring, controller calls, and cross-chain demos | |
| 79 | | Datasets and evals | [`datasets/`](./datasets/), [`evals/`](./evals/) | Cairo audit/evaluation corpora and deterministic benchmark material | |
| 80 | | Docs | [`docs/`](./docs/) | Architecture, roadmap, deployment status, security runbooks, and launch material | |
| 81 | | Website | [`website/`](./website/) | Documentation site source | |
| 82 | |
| 83 | ## Architecture |
| 84 | |
| 85 | ```mermaid |
| 86 | flowchart TB |
| 87 | Agent["Agent runtime<br/>(Codex, Claude Code, OpenClaw, custom app)"] --> Tools["Tool layer<br/>MCP, A2A, skills"] |
| 88 | Tools --> Signer["Signer boundary<br/>direct for local dev, proxy for production"] |
| 89 | Signer --> Starknet["Starknet"] |
| 90 | Starknet --> Accounts["Agent/session accounts<br/>policy enforcement"] |
| 91 | Starknet --> Registries["ERC-8004 registries<br/>identity, reputation, validation"] |
| 92 | Tools --> Packages["TypeScript helpers<br/>passport, onboarding, x402, scanners"] |
| 93 | ``` |
| 94 | |
| 95 | The recommended launch profile is self-custodial and no-backend: |
| 96 | |
| 97 | - users run the agent runtime locally or on their own infrastructure |
| 98 | - account contracts enforce transaction policy on-chain |
| 99 | - production signer custody lives behind an explicit proxy/KMS/HSM boundary |
| 100 | |
| 101 | ## Core Components |
| 102 | |
| 103 | ### Contracts |
| 104 | |
| 105 | | Component | Path | Description | |
| 106 | |---|---|---| |
| 107 | | Agent account | [`contracts/agent-account`](./contracts/agent-account/) | Session keys, spending policy enforcement, ownership controls, and upgrade safety checks | |
| 108 | | ERC-8004 Cairo | [`contracts/erc8004-cairo`](./contracts/erc8004-cairo/) | Identity, reputation, and validation registries adapted to Starknet | |
| 109 | | Session account | [`contracts/session-account`](./contracts/session-account/) | Session-key account primitives for policy-centric execution | |
| 110 | | Huginn registry | |
Related
6 picksType
- azure-messagingTroubleshoot and resolve issues with Azure Messaging SDKs for Event Hubs and Service Bus.Jul 2026
- lark-openapi-explorer飞书/Lark 原生 OpenAPI 探索：从官方文档库中挖掘未经 CLI 封装的原生 OpenAPI 接口。当用户的需求无法被现有 lark-* skill 或 lark-cli 已注册命令满足，需要查找并调用原生飞书 OpenAPI 时使用。Jul 2026
- lark-skill-maker创建 lark-cli 的自定义 Skill。当用户需要把飞书 API 操作封装成可复用的 Skill（包装原子 API 或编排多步流程）时使用。Jul 2026
- implementImplement a piece of work based on a spec or set of tickets.Jul 2026
- supabaseUse when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client…Jul 2026
- firebase-basicsProvides foundational setup, authentication, and project management workflows for Firebase using the Firebase CLI.Jul 2026
