A multi-assistant skill generator (Claude/Windsurf/Cursor/GitHub Skills) driven by a canonical SkillSpec.
npm install neo-skill一个确定性的 skill-creator 仓库。
GitHub: https://github.com/liuminxin45/neo-skill
npm: https://www.npmjs.com/package/neo-skill
``bash通过 npm 安装(推荐)
npm install -g neo-skill
前置依赖:需要安装 Python 3.8+
使用方式
$3
`bash
初始化技能(从 npm 包安装所有 skills)
omni-skill init --ai windsurf手动安装本地创建的 skill
omni-skill install ./skills/my-new-skill更新 npm 包并重新初始化
omni-skill update查看帮助
omni-skill --help
`$3
`bash
初始化技能
python -m omni_skill.cli init --ai claude生成技能输出
python -m skill_creator.cli generate skills/skill-name/skillspec.json验证技能
python -m skill_creator.cli validate skills/skill-name/skillspec.json
`功能说明
- 使用 canonical skills/ 作为单一真源(single source of truth)
- 为多个 AI 助手生成入口文件:
- Claude: .claude/skills/ + resources/
- Windsurf: .windsurf/workflows/
- Cursor: .cursor/commands/
- GitHub / VS Code Skills: .github/skills/ + resources
- 校验生成的 SKILL.md 是否符合 Claude 严格的元数据规则
- 打包 Claude .skill(zip 格式,符合正确的根目录结构)支持的 Skills
| Skill 名称 | 描述 | 来源 |
|-----------|------|------|
| skill-creator | 对话式收集需求,生成可在多 AI Assistant 运行的技能包 | 内置 |
| review-gate | 建立架构与工程化 PR Review 规范,提供可执行的 Review Checklist | 内置 |
触发示例:
- skill-creator: "我想做一个 skill"、"帮我生成 SKILL.md"、"把我的 prompt 工作流变成 skill"
- review-gate: "我想建立 PR Review 架构规范检查点"、"帮我生成 PR Review Checklist 模板"、"软评审代码"
快速开始
$3
$3
1. 初始化技能(首次使用)
`bash
初始化指定 AI 助手的技能文件
omni-skill init --ai windsurf
omni-skill init --ai claude
omni-skill init --ai all # 初始化所有支持的 AI 助手
`这会:
- 从 npm 包同步 skills/ 和 .shared/ 到当前目录
- 为所有 skills 生成指定 AI 助手的输出文件
-
--ai windsurf → 只生成 .windsurf/workflows/
- --ai claude → 只生成 .claude/skills/
- --ai all → 生成所有目标
- 保存初始化状态到 .neo-skill.json2. 使用 skill-creator 创建新 skill
在 IDE 中输入
/skill-creator(Windsurf)或使用其他 AI 助手的触发方式,按照对话式流程创建新 skill。3. 安装刚创建的 skill
`bash
安装单个 skill
omni-skill install ./skills/my-new-skill或安装整个 skills 目录
omni-skill install ./skills
`这会:
- 复制 skill 到当前目录的 skills/ 文件夹
- 为该 skill 生成所有 AI 助手的输出文件(.windsurf, .claude, .cursor, .github)
注意:与
init 不同,install 命令总是生成所有 AI 目标的输出,以确保最大兼容性。4. 更新 npm 包
`bash
更新到最新版本并重新初始化
omni-skill update
`这会:
- 运行
npm install neo-skill@latest
- 重新执行 omni-skill init(使用保存的 AI 目标)在其他项目中使用
将 neo-skill 仓库克隆到你的项目中(例如
vendor/neo-skill/),然后:
1. 设置 PYTHONPATH:export PYTHONPATH=$PWD/vendor/neo-skill/src:$PYTHONPATH
2. 运行命令:omni-skill init --ai claude支持的 AI 助手:
claude, cursor, windsurf, antigravity, copilot, kiro, codex, qoder, roocode, gemini, trae, opencode, continue, all
Canonical 与生成文件
$3
- skills/
- skills/
- skills/(可选)
- skills/(可选)$3
- .windsurf/workflows/
- .windsurf/workflows/data/(从 skills/ 同步)
- .claude/skills/
- .cursor/commands/
- .github/skills/