Combo 🎮

Skill discovery, installation, and orchestration hub for Claude Code

English | 中文

---

English

Overview

Combo is a meta-skill that orchestrates other skills. It doesn't do work manually - it delegates to specialized skills.

User Task → [Combo] → Analyze → Match Skills → Delegate → Deliver 🏆

Core Principle

⚠️ Combo is an ORCHESTRATOR, not an executor.

When a task matches a loaded skill's description,
Combo delegates via Skill tool instead of doing work manually.

Features

Feature	Description
🔍 Smart Search	Search 6+ registries with comparison & recommendation
📦 Multi-Format Install	SKILL.md, Claude Plugin, NPX formats
🔥 Hot Load	Use newly installed skills without restart
🎯 Dynamic Routing	Auto-delegate based on skill descriptions
🔄 Source Updater	4 strategies to keep sources up-to-date

Pre-configured Sources

Priority	Source	Description
1	anthropics/skills	Official Anthropic skills
2	vercel-labs/agent-skills	React, Next.js, frontend
3	skills.sh	90+ tools, 33K+ installs
4	VoltAgent/awesome-claude-skills	Community curated list
5	obra/superpowers	Superpowers skills
6	affaan-m/everything-claude-code	Comprehensive collection

Installation

# Copy to Claude skills directory
cp -r combo ~/.claude/skills/

# Or clone from GitHub
git clone git@github.com:dawei008/combo.git ~/.claude/skills/combo

Usage

CLI Commands

# Smart search (recommended)
combo search "security review"

# Install skill
combo install pdf
combo install my-skill --source user/repo

# List skills
combo list              # Local installed
combo list --remote     # Remote available
combo list --all        # All

# Update sources
combo update            # Full update

# Source management
combo sources
combo sources --add user/repo

In Claude Code

Combo triggers automatically when you:

• Ask "what skill can help me with X?"
• Request skill installation or management
• Need multi-skill orchestration

Delegation Examples

User: "Review this code for security"
Combo: *scans Available skills, finds security-review*
Combo: *delegates via Skill tool*

User: "Create a presentation from this data"
Combo: *matches xlsx + pptx skills*
Combo: *orchestrates multi-skill workflow*

Architecture

combo/
├── SKILL.md              # Core instructions
├── SECURITY.md           # Security review report
├── scripts/
│   ├── combo.py          # Unified CLI
│   ├── skill_registry.py # Discovery & search
│   ├── skill_installer.py# Installation
│   └── source_updater.py # Source management
├── config/
│   └── sources.json      # Source configuration
└── tests/                # Test suite

Security

This codebase has been reviewed using /security-review skill:

• ✅ No hardcoded secrets
• ✅ No shell injection risks
• ✅ No unsafe code execution
• ✅ All network requests have timeouts

See SECURITY.md for full report.

---

中文

概述

Combo 是一个元技能，用于编排其他 skill。它不手动执行工作，而是委派给专门的 skill。

用户任务 → [Combo] → 分析 → 匹配 Skill → 委派 → 交付 🏆

核心原则

⚠️ Combo 是编排器，不是执行器。

当任务匹配某个已加载 skill 的描述时，
Combo 通过 Skill 工具委派，而不是手动执行。

功能特性

功能	描述
🔍 智能搜索	搜索 6+ 注册源，带比较和推荐
📦 多格式安装	支持 SKILL.md、Claude Plugin、NPX 格式
🔥 热加载	新安装的 skill 无需重启即可使用
🎯 动态路由	根据 skill 描述自动委派
🔄 源更新器	4 种策略保持源最新

预配置源

优先级	源	描述
1	anthropics/skills	Anthropic 官方 skills
2	vercel-labs/agent-skills	React、Next.js、前端
3	skills.sh	90+ 工具，33K+ 安装量
4	VoltAgent/awesome-claude-skills	社区精选列表
5	obra/superpowers	Superpowers skills
6	affaan-m/everything-claude-code	综合 skills 集合

安装

# 复制到 Claude skills 目录
cp -r combo ~/.claude/skills/

# 或从 GitHub 克隆
git clone git@github.com:dawei008/combo.git ~/.claude/skills/combo

使用方法

CLI 命令

# 智能搜索（推荐）
combo search "安全审查"

# 安装 skill
combo install pdf
combo install my-skill --source user/repo

# 列出 skills
combo list              # 本地已安装
combo list --remote     # 远程可用
combo list --all        # 全部

# 更新源
combo update            # 完整更新

# 源管理
combo sources
combo sources --add user/repo

在 Claude Code 中

Combo 在以下情况自动触发：

• 询问"有什么 skill 可以帮我做 X？"
• 请求安装或管理 skill
• 需要多 skill 编排

委派示例

用户: "审查这段代码的安全性"
Combo: *扫描 Available skills，找到 security-review*
Combo: *通过 Skill 工具委派*

用户: "把这些数据做成演示文稿"
Combo: *匹配 xlsx + pptx skills*
Combo: *编排多 skill 工作流*

项目结构

combo/
├── SKILL.md              # 核心指令
├── SECURITY.md           # 安全审查报告
├── scripts/
│   ├── combo.py          # 统一 CLI
│   ├── skill_registry.py # 发现和搜索
│   ├── skill_installer.py# 安装
│   └── source_updater.py # 源管理
├── config/
│   └── sources.json      # 源配置
└── tests/                # 测试套件

安全性

代码已通过 /security-review skill 审查：

• ✅ 无硬编码密钥
• ✅ 无 shell 注入风险
• ✅ 无不安全代码执行
• ✅ 所有网络请求有超时

完整报告见 SECURITY.md。

---

License

Apache License 2.0