Claude Code, Cursor, OpenCode, Cline, Continue, Codex, GitHub Copilot, Augment, Roo Code, Windsurf, Amp, Kimi CLI, Replit, Antigravity, OpenClaw, CodeBuddy, Command Code, Crush, Droid, Gemini CLI, Goose, Junie, iFlow CLI, Kilo Code, Kiro CLI, Kode, MCPJam, Mistral Vibe, Mux, OpenHands, Pi, Qoder, Qwen Code, Trae, Trae CN, Zencoder, Neovate, Pochi, AdaL

命令

link - 链接本地 skill

将本地 skill 目录链接到全局注册表，使用软链接实现热更新。

# 链接当前目录（必须包含 skill.md）
j-skills link

# 链接指定目录
j-skills link /path/to/skill

# 列出已链接的 skills
j-skills link --list

# 取消链接
j-skills link --unlink <skill-name>

# JSON 输出（LLM 友好）
j-skills link --list --json

JSON 输出示例：

{
  "skills": [
    {
      "name": "my-skill",
      "path": "/Users/dev/my-skill",
      "source": "linked",
      "installedAt": "2024-01-15T10:30:00.000Z"
    }
  ]
}

install - 安装 skill

将 skill 安装到指定环境的项目或全局目录。不传 --global 时为当前项目，传 --global 时为用户全局（对所有项目生效）。

# 当前项目安装（默认）
j-skills install <skill-name> --env claude-code,cursor

# 全局安装
j-skills install <skill-name> --global --env claude-code,cursor

# 交互式安装（会提示选择项目/全局与环境）
j-skills install <skill-name>

# JSON 输出
j-skills install <skill-name> --json

uninstall - 卸载 skill

从已安装的环境中移除 skill。不传 --global 则只卸当前项目，传 --global 则只卸全局；范围未明确时需先引导用户选择（同 install）。

# 当前项目卸载
j-skills uninstall <skill-name> --env claude-code,cursor

# 全局卸载
j-skills uninstall <skill-name> --global --yes

# 交互式卸载
j-skills uninstall <skill-name>

# JSON 输出
j-skills uninstall <skill-name> --json

list - 列出 skills

查看已安装的 skills。

# 列出项目级 skills（默认）
j-skills list

# 列出全局 skills
j-skills list --global

# 列出所有 skills（项目 + 全局）
j-skills list --all

# 搜索 skills
j-skills list --search <keyword>

# JSON 输出（LLM 友好）
j-skills list --json

JSON 输出示例：

{
  "project": {
    "frontend-design": {
      "name": "frontend-design",
      "environments": [
        { "name": "claude-code", "label": "Claude Code", "path": ".claude/skills/frontend-design" },
        { "name": "cursor", "label": "Cursor", "path": ".cursor/skills/frontend-design" }
      ]
    }
  },
  "global": {
    "web-design-guidelines": {
      "name": "web-design-guidelines",
      "environments": [
        { "name": "claude-code", "label": "Claude Code", "path": "~/.claude/skills/web-design-guidelines" }
      ]
    }
  }
}

config - 配置管理

管理全局配置。

# 查看配置
j-skills config

# JSON 输出
j-skills config --json

路径规范

j-skills 遵循 Vercel Skills 规范：

Agent	项目路径	全局路径
Claude Code	`.claude/skills/`	`~/.claude/skills/`
Cursor	`.cursor/skills/`	`~/.cursor/skills/`
OpenCode	`.agents/skills/`	`~/.config/opencode/skills/`
Cline	`.cline/skills/`	`~/.cline/skills/`

工作流程

创建 Skill - 创建包含 skill.md 的目录
链接本地 - j-skills link
安装到环境 - j-skills install <skill-name>
热更新开发 - 修改本地文件，立即生效

软链接优势

磁盘占用极低
支持热更新
修改本地文件立即生效

使用建议

给 LLM 的建议

当用户询问 j-skills 相关问题时：

安装/卸载范围：若用户未明确说「当前项目」或「全局」，先引导用户选择再执行：
- 当前项目：仅当前仓库生效，不加 --global
- 全局：对所有项目生效，加 --global
使用 --json 选项获取结构化输出
优先使用 j-skills list --all 查看完整状态
安装前先用 j-skills link --list --json 检查已链接的 skills
遇到问题时，让用户提供 --json 输出以便诊断

给开发者的建议

开发阶段使用 link 命令实现热更新
生产环境可以考虑复制而非软链接
使用 --json 输出便于 CI/CD 集成

常见问题

Q: skill 修改后不生效？ A: 确保使用 j-skills link 链接的软链接，而不是直接复制。

Q: 如何查看 skill 已安装到哪些环境？ A: 使用 j-skills list --all --json 查看完整安装信息。

Q: 支持哪些 agent？ A: 运行 j-skills list --help 查看完整列表，或参考官方文档。