https://github.com/stellar/stellar-dev-skill
AI skill for modern Stellar development
https://github.com/stellar/stellar-dev-skill
Last synced: about 2 months ago
JSON representation
AI skill for modern Stellar development
- Host: GitHub
- URL: https://github.com/stellar/stellar-dev-skill
- Owner: stellar
- License: apache-2.0
- Created: 2026-01-22T12:23:51.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-05-11T21:14:54.000Z (about 2 months ago)
- Last Synced: 2026-05-11T23:22:46.031Z (about 2 months ago)
- Homepage:
- Size: 280 KB
- Stars: 29
- Watchers: 0
- Forks: 17
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Stellar Development Skill
A comprehensive AI skill for modern Stellar development with current best practices.
Inspired by [solana-foundation/solana-dev-skill](https://github.com/solana-foundation/solana-dev-skill) and [cloudflare/skills](https://github.com/cloudflare/skills).
> [!NOTE]
> This skill was AI-generated using [Claude Code](https://claude.ai/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.
## Overview
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
## Installing
These skills work with any agent that supports the [Agent Skills](https://agentskills.io) standard.
### [Claude Code](https://code.claude.com/docs/en/discover-plugins#add-from-github)
```bash
# Add this repo as a marketplace
/plugin marketplace add stellar/stellar-dev-skill
# Then install the skill
/plugin install stellar-dev@stellar-dev-skill
```
### [npx skills](https://skills.sh)
```bash
npx skills add https://github.com/stellar/stellar-dev-skill
```
### Clone / Copy
```bash
git clone https://github.com/stellar/stellar-dev-skill
```
Copy the `skills/` directory contents to your assistant's skills location.
| Agent | Skill Directory | Docs |
|-------|-----------------|------|
| Claude Code | `~/.claude/skills/` | [docs](https://code.claude.com/docs/en/skills) |
| OpenCode | `~/.config/opencode/skill/` | [docs](https://opencode.ai/docs/skills/) |
| OpenAI Codex | `~/.codex/skills/` | [docs](https://developers.openai.com/codex/skills/) |
| Pi | `~/.pi/agent/skills/` | [docs](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent#skills) |
## Skill Structure
```
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.
## Example Prompts
```
"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"
```
## Contributing
Contributions are welcome! Please ensure any updates reflect current Stellar ecosystem best practices.
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request
### Guidelines
- Keep information current (check stellar.org/developers for updates)
- Focus on practical, actionable guidance
- Include code examples where helpful
- Cite official documentation when possible
## Resources
- [Stellar Developers](https://developers.stellar.org)
- [Stellar Discord](https://discord.gg/stellar)
- [Stellar Stack Exchange](https://stellar.stackexchange.com)
- [SDF Blog](https://stellar.org/blog)
## License
Apache-2.0 License - see [LICENSE](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.