Skill & Agent Gateway

Dynamic Context Loading for Claude Code Skills and Agents

An MCP server that provides intelligent discovery, search, and on-demand loading of Claude Code skills and agents — inspired by DCL Wrapper's lazy-loading pattern for MCP servers.

Problem

When using Claude Code with many extensions (OMC, SuperClaude, ECC, Superpowers, etc.), you accumulate 200+ skills and 100+ agents. All their descriptions are loaded into the system prompt on every conversation, consuming thousands of tokens before you even start working.

Solution

This gateway replaces the "load everything" approach with 6 lightweight MCP tools:

| Tool | Purpose | |------|---------| | gateway_discover | Browse skills/agents by category | | gateway_search | Keyword search (CN/EN) | | gateway_load | Load specific skill/agent details | | gateway_recommend | Task-based skill+agent recommendations | | gateway_stats | Ecosystem statistics | | gateway_rebuild_index | Refresh index from disk |

Zero impact on existing frameworks — Cursor's <available_skills>, OMC, SuperClaude, and Superpowers continue working unchanged. The gateway is a purely additive layer.

Quick Start

# 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

MCP Configuration

Claude Code (~/.claude.json)

Add to the mcpServers section:

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

Cursor IDE (~/.cursor/mcp.json)

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

Usage Examples

Discover categories

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

Search for skills

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.

Get task recommendations

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

Load specific skill

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

Architecture

┌─────────────────────────────────────────────┐
│              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/      │
└─────────────────────────────────────────────┘

Design Principles

1. Zero Invasion — Never modifies existing SKILL.md or agent files
2. Additive Only — Existing skill/agent loading mechanisms work unchanged
3. Lazy Loading — Content loaded only when explicitly requested
4. Multi-Source — Scans all known skill/agent directories
5. Auto-Categorize — Intelligent keyword-based categorization
6. Deduplication — Same skill from multiple sources appears once

Scanned Directories

Skills

• ~/.claude/skills/ — Primary skills (OMC, Superpowers, etc.)
• ~/.claude/.agents/skills/ — ECC agent skills
• ~/.claude/.cursor/skills/ — Cursor-specific skills
• ~/.cursor/skills-cursor/ — Cursor skills (alternate location)
• ~/.codex/skills/ — Codex skills
• ~/.agents/skills/ — Agent skills (Lark, etc.)
• ~/.claude/plugins/cache/ — Plugin cache (all frameworks)

Agents

• ~/.claude/agents/ — Agent definitions

Categories

| Category | Label | Description | |----------|-------|-------------| | development | 开发工具 | Coding standards, build tools | | architecture | 架构设计 | System design, patterns, frameworks | | testing | 测试 | TDD, unit/integration/E2E testing | | review | 代码审查 | Code review, refactoring | | security | 安全 | Security audit, vulnerability detection | | research | 研究 | Web search, deep research | | communication | 沟通写作 | Docs, articles, social media | | devops | 运维部署 | CI/CD, Docker, Git workflows | | orchestration | 编排调度 | Multi-agent, parallel execution | | lark | 飞书 | Lark/Feishu integrations | | language | 编程语言 | Language-specific patterns | | platform | 平台工具 | Obsidian, GitHub, X, MCP | | planning | 规划管理 | Task planning, requirements | | learning | 学习教育 | Tutorials, mentoring | | business | 商业领域 | Supply chain, logistics, energy |

Configuration

Edit config.json to customize scanned directories:

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

Standalone Indexer

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

Requirements

• Python 3.11+
• MCP Python SDK (mcp>=1.0.0)
• python-dotenv

License

MIT