███████╗██████╗ ███████╗██████╗  █████╗ ██╗  ██╗    ███████╗██╗  ██╗██╗██╗     ██╗     ███████╗
██╔════╝██╔══██╗██╔════╝██╔══██╗██╔══██╗╚██╗██╔╝    ██╔════╝██║ ██╔╝██║██║     ██║     ██╔════╝
███████╗██████╔╝█████╗  ██████╔╝███████║ ╚███╔╝     ███████╗█████╔╝ ██║██║     ██║     ███████╗
╚════██║██╔═══╝ ██╔══╝  ██╔══██╗██╔══██║ ██╔██╗     ╚════██║██╔═██╗ ██║██║     ██║     ╚════██║
███████║██║     ███████╗██║  ██║██║  ██║██╔╝ ██╗    ███████║██║  ╚██╗██║███████╗███████╗███████║
╚══════╝╚═╝     ╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝    ╚══════╝╚═╝   ╚═╝╚═╝╚══════╝╚══════╝╚══════╝

Open-source AI agent skills for DeFi, Web3, and the Sperax ecosystem

Publish. Install. Teach any AI agent about crypto — in seconds.

     

Quick Start · Catalog · Publishing · Contributing · Docs · FAQ

     

Table of Contents

1. About
2. Why Sperax Skills
3. Key Features
4. Quick Start
5. Skill Catalog (skills, 8 categories)
6. Architecture
7. Publishing
8. Machine-Readable Context
9. Ecosystem
10. FAQ
11. Contributing
12. License

(back to top)

🧠 About

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.

(back to top)

🆚 Why Sperax Skills?

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.

(back to top)

✨ Key Features

• 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.txt and llms-full.txt for bulk LLM consumption.

(back to top)

🚀 Quick Start

Install via ClawHub CLI

# Install the CLI
npm install -g @openclaw/clawhub

# Search for Sperax skills
clawhub search sperax

# Install a skill
clawhub install sperax-usds-guide

Use Directly

Each 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/

For SperaxOS

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.

(back to top)

📚 Skill Catalog

🏦 Sperax Ecosystem (5)

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

⚡ Plutus Ecosystem (3)

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

📊 DeFi Knowledge (11)

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

🤖 AI Agent + Web3 (4)

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

📈 Market Intelligence (5)

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

🔥 Hot Topics (5)

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

🛠 Developer / Power User (5)

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

📚 Reference (3)

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

(back to top)

🏗 Architecture

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

Skill Format

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.

(back to top)

📦 Publishing

Publish to ClawHub

# 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

Sync Changes

# Publish only changed skills
./bin/publish-all.sh --changed

# Dry run (preview what would be published)
./bin/publish-all.sh --dry-run

Validate Before Publishing

# Run validation on all skills
./bin/validate.sh

# Regenerate LLM context files
./scripts/generate-llms-txt.sh

(back to top)

📡 Machine-Readable Context

This 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

(back to top)

🌐 Ecosystem

	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

(back to top)

❓ FAQ

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.

(back to top)

🤝 Contributing

Contributions are what make open-source great. Any contribution you make is greatly appreciated.

1. Fork the project
2. Create your branch (git checkout -b feat/amazing-skill)
3. Add your skill in skills/your-skill-name/SKILL.md
4. Validate (./bin/validate.sh)
5. Commit (git commit -m '✨ feat: add amazing-skill')
6. Push (git push origin feat/amazing-skill)
7. Open a Pull Request

See CONTRIBUTING.md for the full style guide and conventions.

(back to top)

📄 License

Distributed under the MIT License. See LICENSE for more information.

Sperax Foundation, 2025–2026

(back to top)

---

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