stellar-dev

Stellar Development Skill

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.

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 standard.

Claude Code

# 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

npx skills add https://github.com/stellar/stellar-dev-skill

Clone / Copy

git clone https://github.com/stellar/stellar-dev-skill

Copy the skill/ 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

Skill Structure

skill/
├── SKILL.md                    # Main skill definition (required)
├── contracts-soroban.md        # Soroban smart contract development
├── frontend-stellar-sdk.md     # Frontend integration patterns
├── testing.md                  # Testing strategies
├── stellar-assets.md           # Asset issuance and management
├── zk-proofs.md                # ZK proof architecture and verification patterns
├── api-rpc-horizon.md          # API access (RPC/Horizon)
├── security.md                 # Security checklist
├── common-pitfalls.md          # Common issues and solutions
├── advanced-patterns.md        # Advanced Soroban architecture patterns
├── standards-reference.md      # SEP/CAP standards quick reference
├── ecosystem.md                # DeFi protocols, wallets, tools, projects
└── resources.md                # Curated reference links

The skill uses a progressive disclosure pattern. The main SKILL.md provides core guidance, and the AI reads the specialized markdown files only when needed for specific tasks.

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
• Stellar Discord
• Stellar Stack Exchange
• SDF Blog

License

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.