# Clone
git clone https://github.com/YanShawn/skill-agent-gateway.git
cd skill-agent-gateway

# Setup (creates venv, installs deps, builds index)
chmod +x setup.sh
./setup.sh

# Or manual setup
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python indexer.py --stats

{
  "skill-agent-gateway": {
    "command": "/path/to/skill-agent-gateway/.venv/bin/python",
    "args": ["/path/to/skill-agent-gateway/gateway.py"],
    "env": {}
  }
}

{
  "mcpServers": {
    "skill-agent-gateway": {
      "command": "/path/to/skill-agent-gateway/.venv/bin/python",
      "args": ["/path/to/skill-agent-gateway/gateway.py"],
      "env": {}
    }
  }
}

gateway_discover()
→ Lists all categories with counts (development, architecture, testing, etc.)

gateway_search(query="飞书日历")
→ Finds lark-calendar, lark-workflow-standup-report, etc.

gateway_search(query="tdd", resource_type="skill")
→ Finds tdd-workflow, tdd-guide, test-driven-development, etc.

gateway_recommend(task_description="重构后端 API 并写测试")
→ Skills: backend-patterns, tdd-workflow, api-design
→ Agents: code-reviewer, tdd-guide, refactoring-expert

gateway_load(name="web-access", resource_type="skill")
→ Category, description, triggers, keywords, file path

gateway_load(name="web-access", resource_type="skill", detail_level="full")
→ Complete SKILL.md content

┌─────────────────────────────────────────────┐
│              AI Agent (Claude)               │
├─────────────────────────────────────────────┤
│   gateway_discover / search / load / ...    │ ← 6 MCP tools
├─────────────────────────────────────────────┤
│           Skill Agent Gateway               │ ← This server
│    ┌──────────┐  ┌──────────┐               │
│    │ Indexer   │  │ Searcher │               │
│    └────┬─────┘  └────┬─────┘               │
│         │              │                     │
│    ┌────▼──────────────▼─────┐               │
│    │      index.json         │               │
│    └─────────────────────────┘               │
├─────────────────────────────────────────────┤
│  ~/.claude/skills/  │ ~/.claude/agents/      │ ← File system
│  ~/.agents/skills/  │ plugins/cache/         │   (unchanged)
│  ~/.codex/skills/   │ ~/.cursor/skills/      │
└─────────────────────────────────────────────┘

{
  "skill_dirs": ["~/.claude/skills", "~/custom/skills"],
  "agent_dirs": ["~/.claude/agents"],
  "plugin_dirs": ["~/.claude/plugins/cache"],
  "skip_agent_names": ["README", "MIGRATION_SUMMARY"]
}

python indexer.py              # Build index with stats
python indexer.py --json       # Output raw JSON
python indexer.py --validate   # Validate existing index
python indexer.py --stats      # Build with detailed breakdown