Skip to content

Latest commit

 

History

History
354 lines (265 loc) · 18.9 KB

File metadata and controls

354 lines (265 loc) · 18.9 KB

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:

Collection Skills Status Focus
SpoonOS Skills 8 🟢 Core Vibe Coding for agent development
Challenge Track Skills Status Focus
Web3 Data Intelligence 2 🔵 Open for Submissions On-chain analysis & insights
Web3 Core Operations 9 🔵 Open for Submissions Smart contracts & protocols
AI-Enhanced Productivity 6 🔵 Open for Submissions API & automation
Enterprise & Team Skills 6 🔵 Open for Submissions Code quality & collaboration
Platform Challenge - 🆕 Meta Track Skill routing & coverage

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.

Skill Description Scripts
On-Chain Analysis Transaction tracking, whale monitoring 6
Security Analysis Smart contract auditing, vulnerability detection 4

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.

Skill Description Scripts
Bridge Cross-chain transfers 3
DAO Tooling Governance, proposals, treasury 4
DeFi Core DeFi operations 5
DeFi Protocols Protocol-specific integrations 4
Identity & Auth ENS, SIWE, sessions 3
Neo Neo N3 blockchain 4
NFT NFT minting, trading 4
Solana Solana ecosystem 5
Wallet Wallet management 5

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.

Skill Description Status
API Integration REST, GraphQL, webhooks 🔵 Accepting PRs
Database SQL, NoSQL, vector DBs 🔵 Accepting PRs
Messaging Slack, Discord, Email 🔵 Accepting PRs
Cloud Services AWS, GCP, Azure 🔵 Accepting PRs
Monitoring Prometheus, Grafana 🔵 Accepting PRs
Storage S3, GCS, files 🔵 Accepting PRs

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.

Skill Description Status
Code Review Automated review, security scanning 🔵 Accepting PRs
Documentation README, API docs, changelogs 🔵 Accepting PRs
Refactoring Extract, rename, cleanup 🔵 Accepting PRs
Debugging Error analysis, log parsing 🔵 Accepting PRs
Testing Test generation, coverage 🔵 Accepting PRs
Performance Profiling, optimization 🔵 Accepting PRs

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:

You Say Skills Used Generated Output
"Build a trading bot for Uniswap" agent-development, defi Complete SpoonReactSkill agent
"Create a whale monitoring alert" agent-development, onchain-analysis Agent with Telegram/Discord alerts
"Deploy my agent to AWS Lambda" deployment-guide Dockerfile + Lambda handler
"Add security checks to my bot" tool-development, security-analysis Agent that loads security skills

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.

Skill Description Scripts
Agent Development Build AI agents with SpoonReactMCP/SpoonReactSkill 3
Graph Development StateGraph workflow construction 2
ERC-8004 Standard Trustless on-chain agent identity 1
Tool Development MCP tools and toolkit extensions 2
Application Templates Trading bot, NFT minter, DAO assistant 3
Platform Integration Telegram, Discord, REST API, Scheduler 4
Deployment Guide Docker, AWS Lambda, Cloud Run 3
Testing Patterns Unit tests, LLM mocking, graph tests 3

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)
ONEINCH_API_KEY=...
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