https://github.com/0xfnzero/solana-bot-dev-skills
Agent skills for Solana bot development Community-ready skills for Codex, Claude Code, Cursor, and other coding agents when building bots with sol-trade-sdk, solana-streamer, sol-parser-sdk, and sol-safekey.
https://github.com/0xfnzero/solana-bot-dev-skills
ai-skills claude-code claude-skills codex codex-skill copy-trading cursor cursor-ide cursor-skill dex grpc rust skills sniping sol-parser-sdk sol-safekey sol-trade-sdk solana solana-streamer trading-bot
Last synced: about 11 hours ago
JSON representation
Agent skills for Solana bot development Community-ready skills for Codex, Claude Code, Cursor, and other coding agents when building bots with sol-trade-sdk, solana-streamer, sol-parser-sdk, and sol-safekey.
- Host: GitHub
- URL: https://github.com/0xfnzero/solana-bot-dev-skills
- Owner: 0xfnzero
- Created: 2026-03-01T06:23:51.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-26T06:02:56.000Z (7 days ago)
- Last Synced: 2026-05-26T07:20:11.472Z (7 days ago)
- Topics: ai-skills, claude-code, claude-skills, codex, codex-skill, copy-trading, cursor, cursor-ide, cursor-skill, dex, grpc, rust, skills, sniping, sol-parser-sdk, sol-safekey, sol-trade-sdk, solana, solana-streamer, trading-bot
- Language: Shell
- Homepage: https://fnzero.dev/
- Size: 73.2 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
solana-bot-dev-skills
Agent skills for Solana bot development
Community-ready skills for Codex, Claude Code, Cursor, and other coding agents when building bots with sol-trade-sdk, solana-streamer, sol-parser-sdk, and sol-safekey.
English |
中文 |
Website |
Telegram |
Discord
---
## What This Repo Provides
This repo stores skills in the neutral top-level `skills/` directory. The skills are plain `SKILL.md` folders, so they can be installed into different agent tools instead of being tied to only Cursor.
## Why Use These Skills
These skills give coding agents repo-grounded guidance for the FNZero Solana bot SDK stack instead of relying on generic model memory. They help agents:
- choose the right SDK boundary for streaming, parsing, trading, and wallet security;
- avoid stale APIs, unpublished package versions, and Rust-only assumptions when writing Node.js/TypeScript, Python, or Go code;
- wire common bot flows such as sniping, copy trading, account monitoring, simulation, and secure wallet unlock with safer defaults;
- use one shared skill source across Codex, Claude Code, Cursor, and other tools.
The installer copies the same source skills to:
| Tool | Default install path |
|------|----------------------|
| Cursor | `~/.cursor/skills/` |
| Codex | `~/.codex/skills/` |
| Claude Code | `~/.claude/skills/` |
You can override these paths with `CURSOR_SKILLS_DIR`, `CODEX_SKILLS_DIR`, or `CLAUDE_SKILLS_DIR`.
## Skills
| Skill | Purpose |
|-------|---------|
| `solana-bot-sdk-orchestrator` | Chooses SDK boundaries and wires stream, strategy, execution, risk, and wallet layers for Solana bots. |
| `solana-streamer-bot` | Builds bot-facing event streams with `solana-streamer-sdk`: Yellowstone gRPC, ShredStream, callbacks, filters, account updates, and RPC replay. |
| `sol-parser-sdk-bot` | Uses `sol-parser-sdk` directly for parsing, event filters, gRPC subscriptions, account subscriptions, RPC parsing, ShredStream, and parser contribution work. |
| `sol-trade-sdk-bot` | Builds and sends DEX trades with `sol-trade-sdk`: buy/sell params, SWQoS/MEV, gas fee strategy, nonce, ALT, sniping, and copy trading execution. |
| `sol-safekey-bot` | Integrates encrypted wallet and key management with `sol-safekey`: keystores, unlock flow, stdin password handling, and secure bot startup. |
The SDK families include Rust plus multi-language variants where available:
- `sol-parser-sdk`: Rust, Node.js/TypeScript, Python, Go
- `sol-trade-sdk`: Rust, Node.js/TypeScript, Python, Go
Current package names and directly installable package versions:
| SDK | Rust | Node.js/TypeScript | Python | Go |
|-----|------|--------------------|--------|----|
| parser | `sol-parser-sdk@0.5.1` | `sol-parser-sdk-nodejs@0.4.4` on npm | `sol-parser-sdk-python==0.4.5` | `github.com/0xfnzero/sol-parser-sdk-golang@v0.4.5` |
| trade | `sol-trade-sdk@4.0.14` | `sol-trade-sdk@0.1.0` on npm | `sol-trade-sdk==0.1.1` | `github.com/0xfnzero/sol-trade-sdk-golang@v0.1.1` |
The Node.js SDK source repositories currently have newer tags/package metadata than npm (`sol-parser-sdk-nodejs` `v0.4.5`, `sol-trade-sdk-nodejs` `v0.1.1`). The skills call this out so agents do not generate npm install commands for unpublished versions.
For non-Rust code, the skills instruct agents to inspect the target language's README/examples before assuming API names.
## Install
Clone and install:
```bash
git clone https://github.com/0xfnzero/solana-bot-dev-skills.git
cd solana-bot-dev-skills
chmod +x scripts/install.sh
./scripts/install.sh
```
The script:
1. Copies all folders from `skills/` into Cursor, Codex, and Claude Code user-level skill directories.
2. Clones or updates the SDK source repos in this repo root:
- `sol-parser-sdk`
- `sol-trade-sdk`
- `solana-streamer`
- `sol-safekey`
- multi-language parser/trade SDK repos for Node.js, Python, and Go
Install only the skills without cloning SDK source:
```bash
./scripts/install.sh --skills-only
```
## Usage
Ask your coding agent naturally:
- "Build a PumpFun sniper using solana-streamer and sol-trade-sdk."
- "Use sol-safekey so the bot never stores a plaintext private key."
- "Write a copy-trading bot that follows this wallet and simulates first."
- "Use sol-parser-sdk directly to parse a transaction by signature."
- "Port this Rust bot shape to TypeScript using the Node.js SDK variant."
When a task spans multiple SDKs, the orchestrator skill should trigger first, then hand off to the specialized SDK skill.
## Directory Layout
```text
solana-bot-dev-skills/
├── README.md
├── README_CN.md
├── SKILLS_EXTENSION.md
├── scripts/
│ └── install.sh
├── skills/
│ ├── solana-bot-sdk-orchestrator/
│ │ └── SKILL.md
│ ├── solana-streamer-bot/
│ │ └── SKILL.md
│ ├── sol-parser-sdk-bot/
│ │ └── SKILL.md
│ ├── sol-trade-sdk-bot/
│ │ └── SKILL.md
│ └── sol-safekey-bot/
│ └── SKILL.md
├── sol-parser-sdk/ # cloned by install.sh unless --skills-only
├── sol-trade-sdk/ # cloned by install.sh unless --skills-only
├── solana-streamer/ # cloned by install.sh unless --skills-only
├── sol-safekey/ # cloned by install.sh unless --skills-only
└── sol-*-sdk-{nodejs,python,golang}/
```
## Notes
- `skills/` is the canonical source. Tool-specific directories are installation targets, not the repo's storage format.
- The skills are designed for bot development, not financial advice. Generated bots should default to simulation or tiny test amounts until reviewed.
- Do not commit private keys, keystores, API tokens, or `.env` files.