A comprehensive AI skill for modern Stellar development with current best practices.
Inspired by solana-foundation/solana-dev-skill and cloudflare/skills.
Note
This skill was AI-generated using Claude Code and is currently under manual review. We welcome contributions! Please submit PRs, open issues, or provide feedback to help improve this resource for the Stellar ecosystem.
This skill provides AI assistants with deep knowledge of the current Stellar development ecosystem:
- Smart Contracts: Soroban (Rust SDK, WebAssembly)
- Client SDKs: stellar-sdk (JavaScript), Python, Go, Rust
- APIs: Stellar RPC (preferred), Horizon (legacy)
- Assets: Stellar Assets, Stellar Asset Contract (SAC)
- Wallets: Freighter, Stellar Wallets Kit, Smart Accounts (passkeys)
- Testing: Local Quickstart, Testnet, Unit tests
- Security: Soroban-specific patterns, audit checklists
- Ecosystem: DeFi protocols, developer tools, community projects
These skills work with any agent that supports the Agent Skills standard.
# Add this repo as a marketplace
/plugin marketplace add stellar/stellar-dev-skill
# Then install the skill
/plugin install stellar-dev@stellar-dev-skillnpx skills add https://github.com/stellar/stellar-dev-skillgit clone https://github.com/stellar/stellar-dev-skillCopy the skills/ directory contents to your assistant's skills location.
| Agent | Skill Directory | Docs |
|---|---|---|
| Claude Code | ~/.claude/skills/ |
docs |
| OpenCode | ~/.config/opencode/skill/ |
docs |
| OpenAI Codex | ~/.codex/skills/ |
docs |
| Pi | ~/.pi/agent/skills/ |
docs |
skills/
├── soroban/SKILL.md # Soroban contracts + testing + security + patterns + pitfalls
├── dapp/SKILL.md # Frontend, wallets (Freighter, Wallets Kit), signing, smart accounts
├── assets/SKILL.md # Stellar Assets, trustlines, SAC bridge
├── data/SKILL.md # Stellar RPC (preferred) + Horizon (legacy), indexing
├── agentic-payments/SKILL.md # x402 + MPP (Charge + Channel) for AI/machine payments
├── zk-proofs/SKILL.md # ZK verification, BLS12-381, BN254/Poseidon (status-sensitive)
└── standards/SKILL.md # SEPs, CAPs, ecosystem projects, curated reference links
Each sub-skill is a self-contained Agent Skill with its own frontmatter. Cross-references link related skills (e.g., the agentic-payments skill points to soroban for the Soroban SACs the protocols call, and to assets for USDC). The AI reads only the sub-skills relevant to the task at hand.
"Help me write a Soroban smart contract for a token"
"Set up a Next.js app with Freighter wallet connection"
"How do I deploy a contract to Stellar Testnet?"
"Create unit tests for my Soroban contract"
"Review this contract for security issues"
Contributions are welcome! Please ensure any updates reflect current Stellar ecosystem best practices.
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
- Keep information current (check stellar.org/developers for updates)
- Focus on practical, actionable guidance
- Include code examples where helpful
- Cite official documentation when possible
Apache-2.0 License - see LICENSE for details.
Note: This repository is not in scope for the Stellar Development Foundation bug bounty program. Vulnerabilities found in this repo are not eligible for rewards.