# 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](./spoonos-skills/) | 8      | 🟢 Core | Vibe Coding for agent development |

| Challenge Track                                     | Skills | Status                  | Focus                        |
| --------------------------------------------------- | ------ | ----------------------- | ---------------------------- |
| [Web3 Data Intelligence](./web3-data-intelligence/) | 2      | 🔵 Open for Submissions | On-chain analysis & insights |
| [Web3 Core Operations](./web3-core-operations/)     | 9      | 🔵 Open for Submissions | Smart contracts & protocols  |
| [AI-Enhanced Productivity](./ai-productivity/)      | 6      | 🔵 Open for Submissions | API & automation             |
| [Enterprise & Team Skills](./enterprise-skills/)    | 6      | 🔵 Open for Submissions | Code quality & collaboration |
| [Platform Challenge](./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](./web3-data-intelligence/onchain-analysis/)  | Transaction tracking, whale monitoring           | 6       |
| [Security Analysis](./web3-data-intelligence/security-analysis/) | Smart contract auditing, vulnerability detection | 4       |

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

[View Web3 Data Intelligence →](./web3-data-intelligence/README.md)

### Track 2: Web3 Core Operations ⚙️

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

| Skill                                                    | Description                     | Scripts |
| -------------------------------------------------------- | ------------------------------- | ------- |
| [Bridge](./web3-core-operations/bridge/)                 | Cross-chain transfers           | 3       |
| [DAO Tooling](./web3-core-operations/dao-tooling/)       | Governance, proposals, treasury | 4       |
| [DeFi](./web3-core-operations/defi/)                     | Core DeFi operations            | 5       |
| [DeFi Protocols](./web3-core-operations/defi-protocols/) | Protocol-specific integrations  | 4       |
| [Identity & Auth](./web3-core-operations/identity-auth/) | ENS, SIWE, sessions             | 3       |
| [Neo](./web3-core-operations/neo/)                       | Neo N3 blockchain               | 4       |
| [NFT](./web3-core-operations/nft/)                       | NFT minting, trading            | 4       |
| [Solana](./web3-core-operations/solana/)                 | Solana ecosystem                | 5       |
| [Wallet](./web3-core-operations/wallet/)                 | Wallet management               | 5       |

**Challenge:** Build skills that enable seamless blockchain protocol interactions.

[View Web3 Core Operations →](./web3-core-operations/README.md)

### 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](./ai-productivity/api-integration/) | REST, GraphQL, webhooks | 🔵 Accepting PRs |
| [Database](./ai-productivity/database/)               | SQL, NoSQL, vector DBs  | 🔵 Accepting PRs |
| [Messaging](./ai-productivity/messaging/)             | Slack, Discord, Email   | 🔵 Accepting PRs |
| [Cloud Services](./ai-productivity/cloud-services/)   | AWS, GCP, Azure         | 🔵 Accepting PRs |
| [Monitoring](./ai-productivity/monitoring/)           | Prometheus, Grafana     | 🔵 Accepting PRs |
| [Storage](./ai-productivity/storage/)                 | S3, GCS, files          | 🔵 Accepting PRs |

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

[View AI-Enhanced Productivity →](./ai-productivity/README.md)

### Track 4: Enterprise & Team Skills 👥

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

| Skill                                               | Description                         | Status           |
| --------------------------------------------------- | ----------------------------------- | ---------------- |
| [Code Review](./enterprise-skills/code-review/)     | Automated review, security scanning | 🔵 Accepting PRs |
| [Documentation](./enterprise-skills/documentation/) | README, API docs, changelogs        | 🔵 Accepting PRs |
| [Refactoring](./enterprise-skills/refactoring/)     | Extract, rename, cleanup            | 🔵 Accepting PRs |
| [Debugging](./enterprise-skills/debugging/)         | Error analysis, log parsing         | 🔵 Accepting PRs |
| [Testing](./enterprise-skills/testing/)             | Test generation, coverage           | 🔵 Accepting PRs |
| [Performance](./enterprise-skills/performance/)     | Profiling, optimization             | 🔵 Accepting PRs |

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

[View Enterprise & Team Skills →](./enterprise-skills/README.md)

### 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 →](./platform-challenge/README.md)

---

## 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

```bash
# 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:

```python
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](./spoonos-skills/agent-development/)         | Build AI agents with SpoonReactMCP/SpoonReactSkill | 3       |
| [Graph Development](./spoonos-skills/graph-development/)         | StateGraph workflow construction                   | 2       |
| [ERC-8004 Standard](./spoonos-skills/erc8004-standard/)          | Trustless on-chain agent identity                  | 1       |
| [Tool Development](./spoonos-skills/tool-development/)           | MCP tools and toolkit extensions                   | 2       |
| [Application Templates](./spoonos-skills/application-templates/) | Trading bot, NFT minter, DAO assistant             | 3       |
| [Platform Integration](./spoonos-skills/platform-integration/)   | Telegram, Discord, REST API, Scheduler             | 4       |
| [Deployment Guide](./spoonos-skills/deployment-guide/)           | Docker, AWS Lambda, Cloud Run                      | 3       |
| [Testing Patterns](./spoonos-skills/testing-patterns/)           | Unit tests, LLM mocking, graph tests               | 3       |

[View SpoonOS Skills Documentation →](./spoonos-skills/README.md)

## Installation

### Option 1: Workspace Skills (Recommended for Vibe Coding)

```bash
# 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

```bash
# 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:

```bash
# 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](./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**:

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

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

## License

MIT License