Claude Skills 管理仓库

个人Claude Code技能管理仓库，支持同步上游更新并管理自定义修改。

目录结构

.
├── README.md
├── sync.sh                 # 同步上游更新
├── third-party/            # 别人的原版skills (submodule)
│   ├── frontend-slides/    # git submodule
│   └── notion-export/
├── modified/               # 你修改后的skills (fork/手动复制)
│   └── frontend-slides/    # 基于原版，但有自己的commit历史
├── custom/                 # 完全自己创建的skills
│   └── my-awesome-skill/
└── scripts/                # 辅助脚本
    ├── add-skill.sh
    └── diff-skill.sh

快速开始

安装 Skills

# 从本仓库的 modified/ 目录安装
npx skills add https://github.com/heyyyss/my-agent-skills/modified --skill frontend-slides

同步上游更新

./sync.sh

查看原版和修改版的差异

./scripts/diff-skill.sh frontend-slides

添加新Skill

添加别人的skill（原版）

./scripts/add-skill.sh third-party https://github.com/original/skill-name.git

添加修改版（基于原版）

# Fork原仓库到GitHub，然后：
./scripts/add-skill.sh modified https://github.com/yourname/skill-name.git

创建自己的skill（custom/）

在 custom/ 目录下创建完全原创的 skill：

mkdir custom/my-new-skill
cd custom/my-new-skill

# 创建标准结构
cat > SKILL.md << 'EOF'
---
name: my-new-skill
description: What it does. Use when user wants to [specific task].
---

# My New Skill

Your skill content here...
EOF

custom/ 目录下的 skill 是你完全自己创建的，不依赖任何上游仓库。

同步工作流

# 1. 拉取所有上游更新
./sync.sh

# 2. 对比某个skill的变化
./scripts/diff-skill.sh frontend-slides

# 3. 决定更新modified版本（手动）
cd modified/frontend-slides
git remote add upstream ../../third-party/frontend-slides
git fetch upstream
git merge upstream/main  # 或 cherry-pick特定提交

本地开发 Workflow

# 1. 克隆管理仓库
git clone https://github.com/heyyyss/my-agent-skills.git
cd my-agent-skills

# 2. 同步上游（拉取 third-party 的更新）
./sync.sh

# 3. 对比并决定是否合并到 modified
./scripts/diff-skill.sh frontend-slides

# 4. 合并更新到 modified
cd modified/frontend-slides
git pull ../../third-party/frontend-slides main

# 5. 解决冲突后提交
git add .
git commit -m "sync: merge upstream changes"

# 6. 推送到你的fork
git push origin main