企业官网建设流程全解析

npx skills 技能本地化：3 步把代理技能装到本地，离线也能跑

【免费下载链接】skillsThe open agent skills tool - npx skills项目地址: https://gitcode.com/GitHub_Trending/ad/skills

npx skills是开放代理技能生态的包管理器，负责技能本地化：把仓库或本地目录里的技能包拉到机器上，挂到你用的编码代理，装完就能离线用。

你什么时候会用到它

• 新拉了团队的仓库，里面约定用几套技能，你得先装到本地才能调试。
• 🔌 内网机器连不了外部源，但同事丢给你一份技能目录，你需要代理技能离线安装：只信自己机器上的文件。
• 装了十几个技能之后，哪份是新版、哪份该删，你不想再去翻目录。

最少三步跑通 npx skills 技能本地化

node -v

要求 Node ≥ 22.20.0，不够先升级，否则后面报的多半是环境错。

npx skills add ./my-local-skills -y

把本地技能目录装进当前项目，默认落到./<agent>/skills/，跟着项目走，-y跳过交互确认。

npx skills ls

确认装上了。清单类似npm ls，一眼看到技能装到哪个代理、项目级还是全局。

按使用场景拆功能

怎么把本地目录装成项目里的技能

npx skills add ./my-local-skills装本地目录，也支持 owner/repo 简写、git URL、直接下载SKILL.md或压缩包。默认用符号链接指向同一份源文件，多个代理共享，更新一次全生效；不支持软链的环境加--copy装独立副本。想所有项目都能用就加-g，装到主目录下的全局位置。

管住已装的技能：看清单、升版本、清掉不要的

本地技能包管理就这三条：npx skills ls看清单（-g只看全局），npx skills update my-skill把单个技能升回源仓库最新版，npx skills remove web-design-guidelines清掉不要的。不指定名字时交互选择，CI 里加-y跳过确认。

不安装，直接用一次某个技能

npx skills use owner/repo@skill-name把技能文件写到临时目录，生成的 prompt 打到 stdout，可以直接管道给你的代理。适合"就用一次，不想留在本地"的场景。

从零造一个新技能

npx skills init my-skill在子目录生成带 YAML frontmatter 的SKILL.md模板，name和description是必填项。写完之后，别人用npx skills find pr review这类关键词搜索就能找到你发布的技能。

几个容易踩的坑

• 提示 No skills found：多半是 frontmatter 缺了name或description，或者SKILL.md不在能被发现的目录里——根目录或skills/下，嵌套最多三层。
• 📡update和find要联网：装好的技能离线能跑，但update要回源仓库比对版本，find走远程索引，断网时别怪它们。
• 项目级和全局不互通：默认装./<agent>/skills/，remove不带-g不会碰全局那份，删错了作用域就得重装。
• 遥测默认开着，不想上报就设DISABLE_TELEMETRY=1。

相关资源

• 完整命令与参数表：README.md
• 命令实现入口：src/
• 边界行为的测试用例：tests/

【免费下载链接】skillsThe open agent skills tool - npx skills项目地址: https://gitcode.com/GitHub_Trending/ad/skills