Tech

Skills 装在哪，全局与项目级的取舍

skills

这篇笔记记录我管理 skills 的方法，要解决的问题就一个，每个 skill 装在哪个位置。看懂开头的原则，后面的清单可以照着操作。

一开始所有 skills 都装在全局，图使用方便，任何目录打开就能用。后来发现全局 skills 每次会话都会加载到上下文里，上下文宝贵，装得越多，留给正事的空间越少。于是改成按使用频度分位置。最常用、属于开发核心的 skills 装全局，只在特定任务才用到的，装在真正会用它的项目目录里。

总览

安装位置 skills
全局 matt-pocock-skills、anysearch、byted-web-search、diagram-design、show-me、tech-doc-style-chinese、baoyu-design
笔记库、博客仓库 humanizer-zh-moli、human-writing、5km-littlebox-illustrations、baoyu-cover-image、baoyu-article-illustrator、punk-cover、punk-avatar、kami、frontend-slides
独立的字幕项目 baoyu-youtube-transcript

大多数 skill 用 npx skills 安装。加 -g 装到全局，不加则装到当前目录的项目里。

1
2
3

npx skills add <仓库地址>          # 装到当前项目
npx skills add <仓库地址> -g       # 装到全局
npx skills rm -g <skill 名>        # 从全局卸载

个别 skill 依赖仓库里的共享资源，不能直接用 npx skills 安装。Punk-Skill 的安装方法见下文。

一、全局安装

全局只留跨项目、几乎每天都要用的。开发流程、搜索、画图、文档写作这四类，在任何目录干活都可能用到，放全局最省事。

matt-pocock-skills

主开发流程，一套从需求到评审的工程化 skills。所有开发任务都走同一条流水线，grill-with-docs → to-spec → to-tickets → implement → code-review。先反复追问把想法磨清楚，落成 spec，拆成 ticket，再实现，最后评审。这是开发工作的主干，必须在全局。

搜索类。anysearch 是实时搜索，支持网页搜索、垂直域搜索、批量搜索和 URL 内容提取。byted-web-search 是火山引擎的豆包搜索，返回网页和图片结果。查资料、核实事实是高频动作，两个都装全局，互为补充。

diagram-design

画各类技术和产品图，架构图、流程图、时序图、状态机、ER 图、时间线、泳道图等等。写文档、整理思路时随手要用，装全局。

show-me

把当前正在聊的话题用简明的图、代码结构草图和聚焦的 HTML 页面讲清楚，帮助理解。讲解和讨论场景下随时可能触发，装全局。

1

npx skills add humanlayer/skills --skill show-me -g

tech-doc-style-chinese

中文技术文档写作风格，克制、准确、可扫读。写技术文档、产品文案、API 说明、操作手册时用，装全局。

1

npx skills add https://github.com/Fenng/tech-doc-style-chinese -g

baoyu-design

宝玉把 Claude Design 打包成的可移植设计 skill，产出是自包含的 HTML 设计稿。能力面很宽，覆盖 13 类产出，幻灯片、移动应用界面、线框图、文档、动画、UI 高保真稿、简历、3D 对象、调研报告、HTML 邮件、配色字体系统、图表、传单都在其中。还支持创建和复用设计系统、离线导入 Figma 文件、把成品导出成 PDF、PPTX 和 MP4。所有产出统一放在 designs/<项目名>/ 目录，不会散落得到处都是。

我的用法集中在其中一个场景，把内容排版成适合阅读的 HTML 页面。Markdown 适合写作和存档，但要发出去给别人看，或者自己回头通读，排版精美的 HTML 读起来舒服得多。这个需求不限于某个目录，工作文档、调研报告、笔记整理都可能碰到，所以装全局。

1

npx skills add JimLiu/baoyu-design -g

用法示例，把一篇 Markdown 笔记排成适合阅读的 HTML 页面。

/baoyu-design 把这篇笔记排版成一个精美的、适合阅读的 HTML 页面，自包含单个文件，方便直接发给同事阅读

二、笔记库、博客仓库

和内容创作相关的 skills，装在 obsidian 笔记库和 hugo 博客源码仓库。这两处是我写东西的地方，写作、配图、排版、做演示的需求只在这里出现。文档目录也归这一类，文档同样是写出来给别人看的内容，和笔记、博客是同一类场景。

humanizer-zh-moli、human-writing

写作打磨两件套。humanizer-zh-moli 负责去 AI 味，在不改原意的前提下重写文本，去掉模型写作的痕迹。human-writing 负责活人感写作，把文章写得像一个查过材料、愿意把来龙去脉讲清楚的人在说话。在笔记库和博客仓库里执行。

1
2

npx skills add moli238/humanizer-zh-moli
npx skills add https://github.com/kkkkhazix/human-writing --skill human-writing

5km-littlebox-illustrations、baoyu-cover-image、baoyu-article-illustrator

文章插图三件套。5km-littlebox-illustrations 画手绘小盒风格的文章插图，baoyu-cover-image 生成文章封面图，baoyu-article-illustrator 分析文章结构、在需要配图的位置生成插图。这三个之前装在全局，实际只在写笔记和博客时用，先卸载再装到项目里。

1
2
3
4
5
6

# 先卸载全局安装的 skills
npx skills rm -g 5km-littlebox-illustrations baoyu-cover-image baoyu-article-illustrator

# 在笔记库或博客仓库目录执行
npx skills add okooo5km/5km-littlebox-illustrations
npx skills add jimliu/baoyu-skills --skill baoyu-cover-image baoyu-article-illustrator

Punk-Skill（punk-cover、punk-avatar）

这个仓库里我主要用 punk-cover，给文章、笔记、推文生成封面图。内置 25 种风格模板，黑白极简概念、商业杂志头版、黑红剪影、Anthropic Research 风格等等，可以指定小红书、公众号、X 这些平台和画幅比例。和 baoyu-cover-image 比，它的特点是给了一批现成的风格模板，不想自己调维度参数的时候用它更省事。仓库里还顺带装了一个 punk-avatar，把人物、宠物、物品的照片生成头像，我用得少。在笔记库或博客仓库目录执行。

Punk-Skill 的两个 skill 依赖仓库根目录的 styles/，直接运行 npx skills add adrianpunk/Punk-Skill 会漏掉这个目录。正确做法是完整克隆仓库，再把两个 skill 链接到项目目录。

1
2
3
4

git clone --depth 1 https://github.com/adrianpunk/Punk-Skill.git .agent-sources/Punk-Skill
mkdir -p .agents/skills
ln -s ../../.agent-sources/Punk-Skill/skills/punk-cover .agents/skills/punk-cover
ln -s ../../.agent-sources/Punk-Skill/skills/punk-avatar .agents/skills/punk-avatar

如果之前已经用 npx skills add 安装过，先运行 npx skills rm punk-cover punk-avatar。以后更新仓库，运行：

1

git -C .agent-sources/Punk-Skill pull --ff-only

用法示例，给文章生成公众号封面，指定风格和比例。

Use $punk-cover to create a WeChat public account cover for this article in 商业杂志头版 style

kami

文档设计系统，用 AI 排版正式文档。简历、一页纸、长文档、正式信件、作品集、幻灯片、财报点评、变更日志、产品落地页都能做。在文档目录执行。

1

npx skills add tw93/kami/plugins/kami

frontend-slides

把内容做成带动画的 HTML 演示文稿，也可以把 PPT 转成网页版。只在笔记等目录做演示时用，之前装在全局，卸载后装到项目里。

1
2
3
4
5

# 先卸载全局安装的 skills
npx skills rm -g frontend-slides

# 在笔记目录执行
npx skills add https://github.com/zarazhangrui/frontend-slides --skill frontend-slides

三、独立的字幕项目

baoyu-youtube-transcript

下载 YouTube 视频字幕的 skill。它不和任何现有项目绑定，单独建一个专门下载字幕的项目，在这个项目里安装，以后所有字幕都下载到这里。

1
2
3
4
5

# 先卸载全局安装的 skills
npx skills rm -g baoyu-youtube-transcript

# 在字幕项目目录执行
npx skills add jimliu/baoyu-skills --skill baoyu-youtube-transcript

用法示例，把视频字幕转成一篇中文技术博客，下载需要走代理。

/baoyu-youtube-transcript 使用这个 skill，将 https://www.youtube.com/watch?v=gaDdrDdczO4 转为一篇中文技术博客，结构清晰重点突出，可以使用代理 export https_proxy=http://127.0.0.1:7897 http_proxy=http://127.0.0.1:7897 all_proxy=socks5://127.0.0.1:7897

维护心得

新装一个 skill 之前，先想清楚它会在什么场景下触发，场景跨项目就装全局，场景固定在某个目录就装到那个项目。装错了也不用纠结，像上面插图三件套那样，npx skills rm -g 卸载全局，再到目标项目里重新装一遍就行。

comments powered by Disqus