用途:把本地维护的技能当作可复用的标准技能资产管理。主要能力包括:将本地来源分类为标准技能、非标准类技能文件夹或混合仓库;把非标准材料转换为基于 SKILL.md 的标准结构;在安装前验证标准技能结构;把一个或多个本地技能同步到一个或多个 agent 技能目录;维护本地技能安装所需的 agent 与 IDE 路径映射。
使用方式:先明确用户是只要分析、迁移、验证、修改映射还是安装。来源结构不明确时,先读 references/source-classification.md 并运行 scripts/inspect-source.mjs。需要迁移时,先读 references/migration-playbook.md,在安装前转换为标准技能文件夹。挂载前读 references/cli-alignment.md 与 references/install-workflow.md,保持本仓库的 source-first 安装模型。结构或路径不确定时,安装前后均可用 scripts/validate-skill.mjs 验证。新增或变更映射前,如目标 agent 较新或不明确,先读 references/mapping-extension.md。常用命令:node skills/manage-local-skills/scripts/inspect-source.mjs --input <path> --json;node skills/manage-local-skills/scripts/validate-skill.mjs --skill-dir <path>;node skills/manage-local-skills/scripts/install-skill.mjs --source-dir skills --skill <name> --agent cursor --scope project --mode symlink。
适用场景:将本地技能安装到 Claude、Cursor、Codex、CodeBuddy 等;把 ./skills 下的内容同步到多个 agent;把 prompts 文件夹转为可复用技能;把本地技能链接到项目 agent 目录。
限制:不用于发布远程技能注册表或包索引、从远程仓库克隆技能、交互式市场搜索,以及与本地技能结构无关的通用文档清理。检查来源时不要执行来源文件夹中的任意脚本。symlink 模式下应保持 skills/ 为唯一维护源,.agents 条目以链接而非副本形式暴露;优先 symlink,用户要求或 symlink 失败时回退到 copy。需明确 scope:project 指当前工作区,global 指用户级 agent 目录。写文件、替换已有安装、更改映射或把非标准来源转为标准技能前,须让用户确认;批量同步多个技能或多个 agent 时,须先汇总计划并等待确认。与 skills CLI 行为不一致时需明确指出差异。其他收费、平台支持等细节暂未提供。