skill-creator

Agent Skills (Macnversion Fork)

本项目是 Anthropic Agent Skills 的 Fork 版本，旨在收集和管理适用于 AI Agent 的各种能力（Skills）。

Skills 是指一组指令、脚本和资源的集合，AI 模型（如 Claude）可以动态加载这些 Skills 来完成特定领域的任务，例如文档处理、代码生成或创意设计。

1. 目录结构规范

每个 Skill 都必须是一个独立的文件夹，并包含核心的描述文件。

标准结构示例

skills/
└── my-skill-name/          <-- Skill 文件夹 (名称必须为小写, 用连字符分隔)
    ├── SKILL.md            <-- [必须] 核心定义文件 (包含 YAML 头信息和 Markdown 指令)
    ├── scripts/            <-- [可选] 辅助脚本 (Python, Node.js 等)
    └── resources/          <-- [可选] 静态资源文件 (模板, 图片等)

SKILL.md 格式要求

SKILL.md 文件必须以 YAML frontmatter 开头：

---
name: my-skill-name        # 必须与文件夹名称一致
description: 简短描述这个 Skill 的功能和适用场景
---

# My Skill Name

[详细的 Prompt 指令内容...]

---

2. 安装与使用指南

本项目支持两种主流的使用场景：Claude Code (命令行工具) 和 Open Code (开源环境)。

场景 A: Claude Code (Marketplace 模式)

在 Claude Code 中，Skills 是通过 Marketplace 插件的形式加载的。

核心机制：白名单

本项目根目录下的 .claude-plugin/marketplace.json 文件充当了 白名单。

• 注意：在 skills/ 目录下添加新文件夹 不会 自动对 Claude Code 可见。
• 必须：您必须在 marketplace.json 的 plugins 列表中显式添加该 Skill 的配置，Claude Code 才能识别和安装它。

安装步骤

1. 注册 Marketplace: 在 Claude Code 终端运行：

   /plugin marketplace add src  # 如果是在当前目录运行
   # 或者指定绝对路径
   /plugin marketplace add /path/to/this/repo
   

2. 安装 Skill:

   /plugin install docx      # 安装单个 Skill
   /plugin install pdf       # 安装单个 Skill
   

   提示：运行 /plugin list 可以查看当前已安装的 Skill。

---

场景 B: Open Code / Antigravity (独立环境)

Open Code 和 Antigravity 等工具通常通过读取本地特定的配置文件目录来加载 Skills。本项目提供了一个统一的自动化脚本，方便您将 Skills 同步到不同 AI 助手的配置环境中。

Skills Manager 工具

我们提供了一个统一的 Python 脚本 skills-manager/manage_skills.py，它支持：

• ✅ Open Code 和 Antigravity 两种目标
• ✅ 全局 (Global) 和工作区 (Workspace) 两种作用域
• ✅ 安装、列出、移除操作
• ✅ 覆盖式更新，确保版本一致

该脚本执行 安装 操作时，采用 全量覆盖 模式（先删除目标文件夹，再复制新文件），以确保您的环境始终是最新的。

使用方法

1. 安装/更新 Skill (覆盖模式):

   # Open Code: 安装单个 Skill
   python3 skills-manager/manage_skills.py install pdf --target opencode
   
   # Open Code: 安装所有 Skills
   python3 skills-manager/manage_skills.py install --all --target opencode
   
   # Antigravity: 安装到全局
   python3 skills-manager/manage_skills.py install pdf --target antigravity
   
   # Antigravity: 安装到工作区
   python3 skills-manager/manage_skills.py install pdf --target antigravity --scope workspace
   

2. 查看已安装列表:

   # Open Code
   python3 skills-manager/manage_skills.py list --target opencode
   
   # Antigravity (全局)
   python3 skills-manager/manage_skills.py list --target antigravity
   
   # Antigravity (工作区)
   python3 skills-manager/manage_skills.py list --target antigravity --scope workspace
   

3. 删除 Skill:

   python3 skills-manager/manage_skills.py remove pdf --target opencode
   python3 skills-manager/manage_skills.py remove pdf --target antigravity
   

4. 查看帮助:

   python3 skills-manager/manage_skills.py --help
   

详细使用说明请参考 skills-manager/README.md。

---

3. 开发须知

如果您想添加一个新的 Skill：

1. 在 skills/ 下创建一个新文件夹（例如 my-new-tool）。
2. 在该文件夹内创建 SKILL.md，并按照规范编写。
3. (针对 Open Code / Antigravity): 直接运行 python3 skills-manager/manage_skills.py install my-new-tool --target <opencode|antigravity> 即可测试。
4. (针对 Claude Code): 编辑 .claude-plugin/marketplace.json，在 plugins 数组中添加一项：

   {
     "name": "my-new-tool",
     "description": "Your description here",
     "source": "./skills/my-new-tool"
   }
   

4. Skills Manager 详细使用指南

作用域说明

Open Code

• Global: ~/.config/opencode/skills/
• Open Code 仅支持全局作用域

Antigravity

• Global: ~/.gemini/antigravity/skills/ - 所有项目可用
• Workspace: <项目>/.agent/skills/ - 仅当前项目可用

快速命令参考

操作	Open Code	Antigravity (Global)	Antigravity (Workspace)
安装单个	--target opencode install <name>	--target antigravity install <name>	--target antigravity --scope workspace install <name>
安装所有	--target opencode install --all	--target antigravity install --all	--target antigravity --scope workspace install --all
列出已安装	--target opencode list	--target antigravity list	--target antigravity --scope workspace list
移除单个	--target opencode remove <name>	--target antigravity remove <name>	--target antigravity --scope workspace remove <name>
移除所有	--target opencode remove --all	--target antigravity remove --all	--target antigravity --scope workspace remove --all

迁移指南

如果你之前使用旧的安装器，可以这样迁移：

# 从 opencode-installer 迁移
# 旧: python opencode-installer/manage_skills.py install --all
# 新: python skills-manager/manage_skills.py --target opencode install --all