一个用于管理 Claude Code 扩展（Skills、MCP、Hooks 等）的个人 marketplace。

• 个人扩展 → Git Submodule 引用（独立 repo，版本可控，方便同步）
• 收集扩展 → 配置文件引用（按需克隆，可选安装）
• 一键安装 → ./install.sh 自动链接到 Claude Code

claude-marketplace/
├── README.md
├── install.sh                   # 一键安装脚本
├── marketplace.yaml             # 主配置文件
├── .gitignore
│
├── skills/
│   └── collected/              # 内置的收集 Skills
│       ├── review/
│       ├── security-review/
│       └── init/
│
├── mcp/
│   └── collected/              # MCP server 配置
│       ├── filesystem/
│       ├── github/
│       └── git/
│
├── external/                    # Submodule 目录 (git 自动管理)
│   ├── skills/
│   │   └── personal/           # 你个人的 Skills repo
│   └── mcp/
│       └── personal/           # 你个人的 MCP repo
│
├── hooks/
│   └── hooks.yaml
│
├── templates/
│   ├── skill-template.md
│   └── mcp-template.yaml
│
└── scripts/
    ├── add-entry.sh
    ├── sync-repos.sh
    └── add-submodule.sh        # 添加个人 submodule

# 克隆主仓库
git clone https://github.com/YOUR_USERNAME/claude-marketplace.git
cd claude-marketplace

# 如果有 submodule，一并克隆
git submodule update --init --recursive

chmod +x install.sh
./install.sh

安装脚本会：

• 链接所有 Skills（内置 + submodule）到 ~/.claude/skills/
• 合并 MCP 配置到 Claude Code 设置
• 配置 Hooks

# 方式一：使用脚本
./scripts/add-submodule.sh skill https://github.com/YOU/your-skill

# 方式二：手动添加
git submodule add https://github.com/YOU/your-skill external/skills/personal/your-skill

./scripts/add-submodule.sh mcp https://github.com/YOU/your-mcp-server

编辑 marketplace.yaml：

skills:
  - name: useful-skill
    source:
      type: remote
      url: https://github.com/someone/useful-skill
    enabled: true

./scripts/add-entry.sh skill my-skill
# 编辑 skills/collected/my-skill/SKILL.md

./scripts/add-entry.sh mcp my-mcp --npm @scope/mcp-server
# 或手动编辑 mcp/collected/my-mcp/config.yaml

# 更新所有 submodule
git submodule update --remote

# 更新特定 submodule
cd external/skills/personal/your-skill
git pull origin main

./scripts/sync-repos.sh

version: 2

skills:
  # Submodule 引用 (个人 repo)
  - name: my-skill
    source: submodule
    path: external/skills/personal/my-skill
    enabled: true

  # 内置 Skill
  - name: review
    source:
      type: inline
      path: collected/review
    enabled: true

  # 远程 Skill (安装时克隆)
  - name: useful-skill
    source:
      type: remote
      url: https://github.com/example/useful-skill
      branch: main
    enabled: true

mcp:
  # npm 包
  - name: github
    source:
      type: npm
      package: "@anthropic-ai/mcp-server-github"
    env:
      GITHUB_TOKEN: "${GITHUB_TOKEN}"
    enabled: true

  # Submodule 引用 (个人 MCP)
  - name: my-mcp
    source: submodule
    path: external/mcp/personal/my-mcp
    enabled: true

  # 远程项目
  - name: custom-mcp
    source:
      type: remote
      url: https://github.com/example/mcp-server
      runtime: python
    enabled: true

方面	Submodule	配置引用
版本控制	锁定 commit，精确可控	默认最新，需额外记录
更新操作	git submodule update --remote	自定义脚本
适用场景	个人 repo，频繁同步	外部项目，按需安装
离线使用	克隆时全部下载	可选择安装哪些

推荐做法：

• 你自己的 Skills/MCP repo → 用 Submodule
• 收集的外部扩展 → 用配置引用

# 1. 克隆仓库（包含 submodule）
git clone --recursive https://github.com/YOU/claude-marketplace.git
cd claude-marketplace

# 2. 运行安装
./install.sh

# 3. 配置环境变量（如需要）
export GITHUB_TOKEN=your_token

# 1. 创建新仓库
mkdir my-new-skill
cd my-new-skill
git init

# 2. 创建 SKILL.md
cat > SKILL.md << 'EOF'
---
name: my-new-skill
description: 技能描述
---
# My New Skill

内容...
EOF

# 3. 推送到 GitHub
git add .
git commit -m "feat: initial commit"
git remote add origin https://github.com/YOU/my-new-skill
git push -u origin main

# 4. 添加到 marketplace
cd ../claude-marketplace
./scripts/add-submodule.sh skill https://github.com/YOU/my-new-skill

MIT