███████╗██████╗ ███████╗██████╗ █████╗ ██╗ ██╗ ███████╗██╗ ██╗██╗██╗ ██╗ ███████╗ ██╔════╝██╔══██╗██╔════╝██╔══██╗██╔══██╗╚██╗██╔╝ ██╔════╝██║ ██╔╝██║██║ ██║ ██╔════╝ ███████╗██████╔╝█████╗ ██████╔╝███████║ ╚███╔╝ ███████╗█████╔╝ ██║██║ ██║ ███████╗ ╚════██║██╔═══╝ ██╔══╝ ██╔══██╗██╔══██║ ██╔██╗ ╚════██║██╔═██╗ ██║██║ ██║ ╚════██║ ███████║██║ ███████╗██║ ██║██║ ██║██╔╝ ██╗ ███████║██║ ╚██╗██║███████╗███████╗███████║ ╚══════╝╚═╝ ╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚══════╝╚═╝ ╚═╝╚═╝╚══════╝╚══════╝╚══════╝
Publish. Install. Teach any AI agent about crypto — in seconds.
Table of Contents
- About
- Why Sperax Skills
- Key Features
- Quick Start
- Skill Catalog (skills, 8 categories)
- Architecture
- Publishing
- Machine-Readable Context
- Ecosystem
- FAQ
- Contributing
- License
A curated collection of ** text-based AI agent skills** that teach any OpenClaw-compatible agent about DeFi protocols, on-chain analytics, portfolio management, and the Sperax + Plutus ecosystems.
Each skill is a standalone SKILL.md file with YAML frontmatter — designed for the ClawHub public registry and compatible with any agent framework that consumes Markdown-based knowledge.
Background — Sperax is a DeFi + AI ecosystem on Arbitrum, comprising USDs (auto-yield stablecoin), SPA/veSPA governance, Sperax Farms, and ERC-8004 (on-chain AI agent identity). Plutus is an allied multichain yield platform and governance aggregator — deeply integrated with Sperax through plsSPA (liquid 4-year max-locked veSPA). Together, these protocols represent a significant portion of Arbitrum's DeFi infrastructure.
SperaxOS is the open-source AI Agent Workspace that consumes these skills — with 45+ built-in DeFi tools, portfolio management, social features, and multi-agent orchestration. These skills power the knowledge layer that makes SperaxOS agents useful on day one.
Why use curated skills instead of rolling your own agent knowledge?
| Sperax Skills | RAG / Vector DB | Fine-Tuning | Prompt Engineering | |
|---|---|---|---|---|
| Setup time | Seconds | Hours | Days | Minutes |
| Cost | Free | Embedding + hosting | GPU compute | Free |
| Accuracy | ✅ Expert-reviewed | Depends on chunks | Good | Hallucination-prone |
| Updatable | git pull |
Re-index | Re-train | Manual |
| Shareable | ✅ ClawHub registry | ❌ Private | ❌ Private | ❌ Copy-paste |
| Multi-agent | ✅ Any OpenClaw agent | Framework-specific | Model-specific | Agent-specific |
| DeFi depth | skills, 7,500 lines | You build it | You label it | You write it |
Sperax Skills give your agent expert DeFi knowledge with zero infrastructure.
- Instant knowledge — Copy a Markdown file. No fine-tuning, no RAG setup, no embeddings.
- expert skills — Covering Sperax, Plutus, DeFi mechanics, market intelligence, and more.
- OpenClaw compatible — Proper YAML frontmatter. Publish to ClawHub in one command.
- Public-safe — No internal codebase details, no API keys, no private architecture exposed.
- Read-only / informational — No execution or transaction logic. Safe for any marketplace.
- Chain-aware — Arbitrum-first with multi-chain context (Berachain, Superseed, BNB Chain).
- CI-validated — Automated slug, frontmatter, and sensitive-pattern checks on every PR.
- Machine-readable —
llms.txtandllms-full.txtfor bulk LLM consumption.
# Install the CLI
npm install -g @openclaw/clawhub
# Search for Sperax skills
clawhub search sperax
# Install a skill
clawhub install sperax-usds-guideEach skill is self-contained. Copy any skills/<slug>/SKILL.md into your agent's context:
# Clone and use
git clone https://github.com/sperax/sperax-skills.git
cp sperax-skills/skills/defi-yield-strategies/SKILL.md ~/my-agent/skills/These skills are automatically loaded by SperaxOS agents. No manual setup needed — they power the built-in knowledge of every DeFi agent in the workspace.
Core skills covering the Sperax protocol — USDs auto-yield stablecoin, SPA governance, no-code farming, and ERC-8004 agent identity.
| Skill | Description |
|---|---|
sperax-ecosystem-overview |
Full ecosystem overview — USDs, SPA, Farms, ERC-8004, SperaxOS |
sperax-usds-guide |
USDs auto-yield stablecoin — minting, redeeming, yield mechanics |
sperax-spa-staking |
SPA staking, veSPA governance, xSPA rewards |
sperax-farms-guide |
No-code liquidity farming on Arbitrum |
erc8004-agent-identity |
ERC-8004 on-chain AI agent identity standard |
Skills covering Plutus DAO — the multichain yield platform and Arbitrum-native governance aggregator. Includes plsASSETs, plvASSET vaults, and tokenomics.
| Skill | Description |
|---|---|
plutus-protocol-overview |
Full protocol overview — plsASSETs, vaults, $PLUTUS/$xPLUTUS tokenomics, governance |
plutus-plsassets-guide |
Liquid governance tokens — plsSPA, plsGRAIL, plsSYK, plsBERA, overcollateralization |
plutus-vaults-guide |
Yield vaults — plvHEDGE, plvDOLO, plvLOOP, risk profiles, multi-chain deployment |
| Skill | Description |
|---|---|
defi-yield-strategies |
Yield farming strategies and risk tiers |
stablecoin-mechanics |
Stablecoin types, pegging, and safety evaluation |
impermanent-loss-explained |
IL formulas for Uniswap V2 and V3, break-even analysis |
defi-risk-assessment |
Protocol risk scoring framework |
crypto-portfolio-management |
Portfolio construction and rebalancing |
mev-protection-guide |
MEV types and protection strategies |
token-approval-safety |
ERC-20 approval risks and management |
dca-strategy-guide |
Dollar cost averaging strategies |
token-swap-best-practices |
DEX aggregators, slippage, gas optimization |
onchain-analytics-guide |
On-chain data analysis and tools |
defi-lending-guide |
Lending protocol mechanics and strategies |
| Skill | Description |
|---|---|
ai-agent-defi-guide |
Teaching AI agents DeFi fundamentals |
agent-wallet-security |
Security for AI agents handling crypto wallets |
arbitrum-defi-guide |
Arbitrum ecosystem — protocols, bridges, opportunities |
crypto-governance-guide |
DAO governance mechanics and participation |
| Skill | Description |
|---|---|
crypto-price-data-guide |
Price pipeline (CEX → DEX → Oracle → Aggregator), free API alternatives |
defillama-analytics-guide |
DeFi Llama API masterclass — TVL, prices, yields, stablecoins |
chainlink-oracle-guide |
Oracle architecture, reading feeds, Chainlink vs Pyth |
crypto-news-aggregation |
News sourcing, RSS feeds, sentiment, daily briefing templates |
whale-watching-guide |
Exchange flows, wallet tracking, Dune queries, smart money |
| Skill | Description |
|---|---|
gas-optimization-guide |
Gas mechanics (L1 vs L2), cost comparison, timing strategies |
airdrop-hunting-guide |
Eligibility criteria, farming strategies, Sybil detection |
crypto-market-sentiment |
Fear & Greed, social sentiment, on-chain indicators |
token-discovery-guide |
On-chain screening, scam detection, evaluation framework |
restaking-explained |
EigenLayer, LRT protocols, risk layers, AVS ecosystem |
| Skill | Description |
|---|---|
subgraph-development-guide |
The Graph — schema, mappings, deployment, queries |
smart-contract-reading-guide |
Reading verified contracts, Solidity for non-devs, ABI decoding |
nft-analytics-guide |
Floor prices, wash trading, ERC-721/1155/8004, valuation |
cross-chain-bridge-guide |
Bridge architectures, trust assumptions, security history |
defi-dashboard-building |
Building analytics with free APIs |
| Skill | Description |
|---|---|
web3-glossary |
150+ term glossary for Web3 and DeFi |
crypto-tax-basics |
Crypto taxation overview and DeFi tax implications |
yield-vault-guide |
Yield vaults, auto-compounding, vault evaluation |
sperax-skills/
├── .github/ # CI workflows, issue templates
│ └── workflows/
│ ├── ci.yml # Validate skills, security scan
│ ├── publish.yml # Publish to ClawHub on release
│ └── secret-scan.yml
├── .well-known/ # ClawHub registry discovery metadata
├── bin/
│ ├── validate.sh # Validate all skills (slug, frontmatter, patterns)
│ └── publish-all.sh # Bulk publish (--dry-run, --changed)
├── docs/
│ ├── style-guide.md # Writing standards for skill content
│ ├── publishing.md # ClawHub publishing workflow
│ └── skill-format.md # YAML frontmatter specification
├── scripts/
│ └── generate-llms-txt.sh
├── skills/ # ← skill folders
│ ├── sperax-ecosystem-overview/
│ ├── plutus-protocol-overview/
│ ├── defi-yield-strategies/
│ └── ...
├── SKILL.md # Root meta-index skill
├── llms.txt # LLM context — summary (~50 lines)
├── llms-full.txt # LLM context — complete (~7,500 lines)
├── CITATION.cff # Academic citation metadata
└── package.json # Scripts: validate, publish, generate
Every skill follows the OpenClaw specification:
---
name: skill-slug-name # Lowercase, hyphens only
description: One-line summary # Used by ClawHub search
metadata:
openclaw:
emoji: "📈" # Display icon
homepage: "https://..." # Link to source project
requires: [] # Dependency skills (optional)
---
# Skill Title
Markdown content — tables, code blocks, ASCII diagrams.
Minimum 100 lines of substantive educational content.
No private code, no API keys, no internal architecture.# Login with your GitHub account
clawhub login
# Publish a single skill
clawhub publish skills/sperax-usds-guide \
--slug sperax-usds-guide \
--version 1.0.0 \
--tags latest \
--changelog "Initial release"
# Bulk publish all skills
./bin/publish-all.sh# Publish only changed skills
./bin/publish-all.sh --changed
# Dry run (preview what would be published)
./bin/publish-all.sh --dry-run# Run validation on all skills
./bin/validate.sh
# Regenerate LLM context files
./scripts/generate-llms-txt.shThis repo includes machine-readable context files for bulk LLM consumption:
| File | Purpose | Size |
|---|---|---|
llms.txt |
Summary index of all skills | ~50 lines |
llms-full.txt |
Complete content of all skills | ~7,500 lines |
SKILL.md |
Root meta-index (publishable to ClawHub) | ~80 lines |
.well-known/clawhub.json |
Registry discovery metadata | JSON |
| Resource | Description | |
|---|---|---|
| 🐾 | ClawHub Registry | Public skill marketplace — search, install, publish |
| 🟣 | Sperax Protocol | USDs stablecoin, SPA governance, Arbitrum DeFi |
| ⚡ | Plutus DAO | Multichain yield platform, governance aggregator, plsSPA |
| 🤖 | SperaxOS | AI Agent Workspace — the platform these skills power |
| 🔗 | ERC-8004 | On-chain AI agent identity standard |
| 📖 | Documentation | Style guide, publishing workflow, skill format spec |
What is an AI agent skill?
A skill is a Markdown file with YAML frontmatter that injects domain knowledge into an LLM-powered agent. Unlike fine-tuning or RAG, skills require zero infrastructure — just copy the file into your agent's context window and it immediately understands the topic.
Do I need SperaxOS to use these?
No. These skills work with any agent framework that accepts Markdown-based knowledge — Claude, GPT, Cursor, Copilot, or any OpenClaw-compatible system. SperaxOS loads them automatically, but they're designed to be framework-agnostic.
Are these safe for public marketplaces?
Yes. Every skill is read-only educational content. No API keys, no file paths, no internal architecture, no transaction execution logic. They pass automated sensitive-pattern scanning on every CI run.
How do I add a new skill?
Fork → create skills/your-skill-name/SKILL.md → follow the style guide → run ./bin/validate.sh → open a PR. Every skill needs valid YAML frontmatter and at least 100 lines of substantive content. See CONTRIBUTING.md for full details.
What's the relationship between Sperax and Plutus?
Plutus DAO is an allied protocol that deeply integrates with Sperax through plsSPA — a liquid receipt token for 4-year max-locked veSPA. This gives Plutus users Sperax governance power while maintaining liquidity. The Plutus skills cover this integration and Plutus's broader yield platform.
Can I use these commercially?
Yes — MIT License. Use them in commercial products, modify them, redistribute them. Attribution appreciated but not required.
Contributions are what make open-source great. Any contribution you make is greatly appreciated.
- Fork the project
- Create your branch (
git checkout -b feat/amazing-skill) - Add your skill in
skills/your-skill-name/SKILL.md - Validate (
./bin/validate.sh) - Commit (
git commit -m '✨ feat: add amazing-skill') - Push (
git push origin feat/amazing-skill) - Open a Pull Request
See CONTRIBUTING.md for the full style guide and conventions.
Distributed under the MIT License. See LICENSE for more information.
Sperax Foundation, 2025–2026
Built with 🧠 by the Sperax team
sperax.io · GitHub @sperax · X @SperaxDAO
⭐ If these skills helped your agent, consider starring the repo — it helps others discover it.