install-skill

Skill 安装器

自动将新技能安装到 skills marketplace 项目中。处理解包、Marketplace 注册和文档更新。

适用场景

• 用户在 dist/ 目录中有一个 .skill 文件
• 用户要求“安装”“添加”“解包”或“集成”某个技能
• 用户想向 Marketplace 添加新技能

安装工作流

阶段 1：发现

1. 列出可用的技能包：

   ls -la dist/*.skill
   

2. 确定目标技能：如果用户指定了技能名称，就使用该名称。否则，列出可用的技能包并询问要安装哪一个。

3. 验证技能包：检查文件是否存在，以及是否为有效的 zip 归档：

   file dist/<skill-name>.skill
   

阶段 2：提取

1. 提取前预览内容：

   unzip -l dist/<skill-name>.skill
   

2. 提取到项目根目录：

   unzip -o dist/<skill-name>.skill
   

3. 验证提取结果：

   ls -la <skill-name>/
   ls -la <skill-name>/references/
   

阶段 3：提取元数据

1. 读取 SKILL.md 的 frontmatter，提取：

   • name：技能标识符（短横线命名）
   • description：用于触发条件的完整描述
   • metadata.category：类别（seo、music、security、tooling 等）
   • metadata.tags：逗号分隔的标签

2. 解析 SKILL.md 顶部 --- 标记之间的 frontmatter

3. 生成简短描述，用于 Marketplace（一行，最多约 60 个字符）

阶段 4：Marketplace 注册

1. 更新 .claude-plugin/marketplace.json：

   a. 如有需要，更新顶层的 description，以包含新类别

   b. 添加到 plugins 数组：

   {
     "name": "<skill-name>",
     "type": "skill",
     "path": "<skill-name>",
     "description": "<short-description>",
     "category": "<category>",
     "tags": ["tag1", "tag2", ...]
   }
   

   c. 如果是新类别，将其添加到 categories 对象：

   "<category>": {
     "name": "<Category Display Name>",
     "description": "<Category description>",
     "marketplace": "marketplace-<category>.json"
   }
   

2. 创建/更新类别 Marketplace（marketplace-<category>.json）：

   如果文件不存在，则使用模板创建：

   {
     "name": "skills-<category>",
     "version": "1.0.0",
     "description": "<Category> skills for Claude Code.",
     "author": "schwepps",
     "license": "MIT",
     "repository": {
       "type": "git",
       "url": "https://github.com/schwepps/skills.git"
     },
     "plugins": [
       { /* skill entry */ }
     ]
   }
   

   如果文件已存在，则将技能添加到 plugins 数组中。

阶段 5：文档更新

1. 更新 README.md：

   a. 如果添加了新类别，则更新标题描述

   b. 添加到“What's Included”表格：

   | **[<skill-name>](<skill-name>/)** | <short-description> |
   

   c. 如果是新类别，则添加使用示例部分：

   ### <Category>
   

   “示例提示词 1” “示例提示词 2”

   d. 添加到“Project Structure”目录树：

   ├── <skill-name>/
   

   e. 添加到“Browser Download”表格：

   | <Skill Display Name> | [Download ZIP](https://download-directory.github.io/?url=https://github.com/schwepps/skills/tree/main/<skill-name>) |
   

阶段 6：验证

1. 验证所有文件均已更新：

   • 技能目录存在，且包含 SKILL.md 和 references/
   • marketplace.json 包含技能条目
   • 类别 Marketplace 文件存在且包含该技能
   • README.md 已更新技能信息

2. 报告摘要：

   Installed: <skill-name>
   Category: <category>
   Files: <count> reference files
   
   Updated:
   - .claude-plugin/marketplace.json
   - .claude-plugin/marketplace-<category>.json
   - README.md
   

类别映射

类别	显示名称	描述
seo	SEO 与 AI 搜索	搜索引擎优化和 AI 搜索可见性
music	音乐创作	AI 驱动的音乐和音频生成
security	智能合约安全	区块链和智能合约审计
tooling	开发者工具	自动化和开发实用工具

错误处理

• 未找到文件：列出 dist/ 中可用的 .skill 文件
• 无效的技能包：检查文件是否为有效的 zip 归档
• 缺少 SKILL.md：技能包格式不正确，无法安装
• 缺少 frontmatter：尽可能提取信息，并询问用户缺失的元数据
• 类别冲突：请用户确认类别归属

快速安装命令

对于目标技能文件已知的简单安装：

/install-skill <skill-name>

此操作将：

1. 解包 dist/<skill-name>.skill
2. 从 SKILL.md 自动检测元数据
3. 在所有 Marketplace 文件中注册
4. 更新 README.md
5. 报告完成状态