Spoonos Official Awesome Skill

spoonos-official-awesome-skill

Source: github.com/XSpoonAi/spoon-awesome-skill. The body below is the upstream README.md captured at the time of registration.

Spoon Awesome Skill

A curated collection of high-quality Claude Code skills for SpoonOS development, Web3 integrations, AI productivity, and enterprise tooling.

57+ Python scripts across 5 Skill Challenge Tracks:

Note: SpoonOS Skills is the foundational collection for Vibe Coding, not a challenge track. You can still submit issues and PRs for improvements.

Skill Challenge Tracks

Three Pillars of Excellence

┌─────────────────────────────────────────────────────────────────────┐
│                    SKILL CHALLENGE STRUCTURE                        │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ┌─────────────────────┐  ┌─────────────────────┐  ┌─────────────┐ │
│  │ TECHNICAL EXCELLENCE │  │ OPERATIONAL         │  │ PLATFORM    │ │
│  │                     │  │ EFFICIENCY          │  │ EVOLUTION   │ │
│  │ • Data Intelligence │  │ • AI Productivity   │  │             │ │
│  │ • Core Operations   │  │ • Enterprise Skills │  │ • Routing   │ │
│  │ • (Security*)       │  │ • (DAO Ops*)        │  │ • Coverage  │ │
│  └─────────────────────┘  └─────────────────────┘  └─────────────┘ │
│                                                                     │
│  * Future expansion tracks                                          │
└─────────────────────────────────────────────────────────────────────┘

Track 1: Web3 Data Intelligence 🧠

Focus: The "Brain" of Web3 - On-chain analysis, indexing, and transforming raw blockchain data into actionable insights.

Challenge: Build skills that transform raw blockchain data into valuable insights.

View Web3 Data Intelligence →

Track 2: Web3 Core Operations ⚙️

Focus: The "Engine Room" of Web3 - Smart contracts, protocol management, and blockchain infrastructure.

Challenge: Build skills that enable seamless blockchain protocol interactions.

View Web3 Core Operations →

Track 3: AI-Enhanced Productivity 🚀

Focus: AI-powered automation for modern development workflows - not just API wrappers, but intelligent automation.

Challenge: Build skills that make AI agents genuinely productive in real-world workflows.

View AI-Enhanced Productivity →

Track 4: Enterprise & Team Skills 👥

Focus: Professional collaboration, project management, security compliance, and team productivity.

Challenge: Build skills that enhance team productivity and code quality at scale.

View Enterprise & Team Skills →

Track 5: Platform Challenge 🏆

Focus: Meta-level improvements to the SpoonOS skill system itself.

Challenge Areas:

• Skill Discovery & Routing: Semantic matching, multi-skill orchestration
• Coverage Analysis: Gap detection, quality metrics
• Platform Optimization: Caching, parallel execution, error recovery
• Developer Experience: Templates, testing frameworks, documentation tools

View Platform Challenge →

Two Skill Collections, Two Purposes

SpoonOS Skills → Vibe Coding

Empower developers to build SpoonOS Agents and applications through Vibe Coding.

Copy SpoonOS skills into .claude/skills/ or .agent/skills/ and describe what you want to build. The AI uses these skills to generate complete, production-ready SpoonOS agents and applications.

Web3 Skills → Skill Agent Integrations

Provide blockchain tools for SpoonOS SpoonReactSkill agents to use.

Web3 skills contain executable scripts that become callable tools when loaded by a SpoonReactSkill agent. Your skill agent can automatically leverage DeFi protocols, security checks, DAO voting, and more.

┌──────────────────────────────────────────────────────────────────┐
│                         Developer                                │
├──────────────────────────────────────────────────────────────────┤
│                            │                                     │
│                      Vibe Coding                                 │
│                            │                                     │
│                            ▼                                     │
│  ┌─────────────────────────────────────────────────────────┐    │
│  │              SpoonOS Skills (.claude/skills/)            │    │
│  │  • Agent Development    • Graph Workflows                │    │
│  │  • Tool Development     • Platform Integration           │    │
│  │  • Deployment Guide     • Testing Patterns               │    │
│  └─────────────────────────────────────────────────────────┘    │
│                            │                                     │
│                     Generates                                    │
│                            │                                     │
│                            ▼                                     │
│  ┌─────────────────────────────────────────────────────────┐    │
│  │              SpoonReactSkill Agent                       │    │
│  │  skill_paths = [".agent/skills/"]                        │    │
│  │  scripts_enabled = True                                  │    │
│  │  auto_trigger_skills = True                              │    │
│  └─────────────────────────────────────────────────────────┘    │
│                            │                                     │
│                      Loads Tools                                 │
│                            │                                     │
│                            ▼                                     │
│  ┌─────────────────────────────────────────────────────────┐    │
│  │              Web3 Skills (.agent/skills/)                │    │
│  │  • Data Intelligence → onchain_analysis, security_scan  │    │
│  │  • Core Operations → defi, dao, nft, bridge, wallet     │    │
│  └─────────────────────────────────────────────────────────┘    │
└──────────────────────────────────────────────────────────────────┘

Vibe Coding with SpoonOS Skills

Copy SpoonOS Skills into your workspace to enable vibe coding - describe what you want and let AI generate production-ready SpoonOS agents:

Quick Setup

# Step 1: Copy SpoonOS Skills for Vibe Coding (Claude Code / Cursor / Windsurf)
mkdir -p .claude/skills
cp -r spoonos-skills/* .claude/skills/

# Step 2: Copy Web3 Skills for your generated agents to use
mkdir -p .agent/skills
cp -r web3-data-intelligence/* .agent/skills/
cp -r web3-core-operations/* .agent/skills/

Just Describe What You Want

With SpoonOS skills installed, describe your goal and the AI generates complete agents:

Example: Building a Web3 Skill Agent

Use SpoonReactSkill to build agents that automatically load and use Web3 skills:

from spoon_ai.agents import SpoonReactSkill
from spoon_ai.chat import ChatBot

# Path to your skills directory
SKILLS_PATH = ".agent/skills"

class DeFiSkillAgent(SpoonReactSkill):
    """
    A DeFi agent that automatically activates Web3 skills.
    Skills provide both prompts AND executable scripts as tools.
    """

    def __init__(self, **kwargs):
        kwargs.setdefault('name', 'defi_skill_agent')
        kwargs.setdefault('description', 'AI agent for DeFi operations')
        kwargs.setdefault('skill_paths', [SKILLS_PATH])
        kwargs.setdefault('scripts_enabled', True)
        kwargs.setdefault('max_steps', 10)
        super().__init__(**kwargs)

    async def initialize(self):
        await super().initialize()
        # Activate relevant skills
        if "defi" in self.list_skills():
            await self.activate_skill("defi")
        if "security-analysis" in self.list_skills():
            await self.activate_skill("security-analysis")


async def main():
    agent = DeFiSkillAgent(
        llm=ChatBot(llm_provider="openai", model_name="gpt-4o"),
        auto_trigger_skills=True,
        max_auto_skills=3
    )
    await agent.initialize()

    result = await agent.run(
        "Check if PEPE token is safe, then find the best swap route for 1 ETH to USDC"
    )
    print(result)


if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

SpoonOS Skills (8 skills, 21 scripts) — For Vibe Coding

Empower developers to build SpoonOS Agents and applications.

View SpoonOS Skills Documentation →

Installation

Option 1: Workspace Skills (Recommended for Vibe Coding)

# Clone the repository
git clone https://github.com/XSpoonAi/spoon-awesome-skill.git

# Copy to your project's skill directory
mkdir -p your-project/.claude/skills
cp -r spoon-awesome-skill/spoonos-skills/* your-project/.claude/skills/
cp -r spoon-awesome-skill/web3-data-intelligence/* your-project/.claude/skills/
cp -r spoon-awesome-skill/web3-core-operations/* your-project/.claude/skills/

Option 2: Global Skills

# Copy to global Claude Code skills directory
cp -r spoon-awesome-skill/spoonos-skills/* ~/.claude/skills/
cp -r spoon-awesome-skill/web3-data-intelligence/* ~/.claude/skills/
cp -r spoon-awesome-skill/web3-core-operations/* ~/.claude/skills/

Environment Variables

Create a .env file with the required API keys:

# LLM Providers
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...

# Blockchain RPCs
ETHEREUM_RPC=https://eth.llamarpc.com
POLYGON_RPC=https://polygon.llamarpc.com
ARBITRUM_RPC=https://arb1.arbitrum.io/rpc
BASE_RPC=https://mainnet.base.org

# Web3 APIs
ETHERSCAN_API_KEY=...
ALCHEMY_API_KEY=...

# DeFi (Optional)
TENDERLY_API_KEY=...

# Wallet (For transactions)
PRIVATE_KEY=0x...
WALLET_ADDRESS=0x...

Contributing

We welcome contributions! See CONTRIBUTING.md for detailed guidelines.

Quick Start

1. Fork the repository
2. Choose a challenge track:
   • web3-data-intelligence/ - On-chain analytics
   • web3-core-operations/ - Protocol interactions
   • ai-productivity/ - AI automation (🔵 Open!)
   • enterprise-skills/ - Team tools (🔵 Open!)
   • platform-challenge/ - Meta improvements (🆕)
3. Create your skill with SKILL.md, README.md, and optional scripts/
4. Submit PR with screenshots of running example

Testing Your Skill

We recommend using SpoonReactSkill, but you can also test with other skill-enabled agents like Claude Code:

# Option 1: SpoonReactSkill (Recommended)
python your_test_agent.py

# Option 2: Claude Code
cp -r your-skill/ .claude/skills/

License

MIT License