makerskills

makerskills 是一套给个人经营者手艺用的 agent 插件，共二十一个技能，装进 Claude Code、Codex、Cursor 或任何认 Agent Skill 格式的环境，并按工种分组：三个用来造更多东西的元技能（skillify、toolify、loopify）、决策与策略（decide、unstuck、maker-council、business-brainstorm、deep-research、domain）、知识与内容消化（second-brain、company-brain、read-book、watch-video、ingest）、产出（jab-hook、slide-deck），以及运营杂务（pm、personal-cfo、company-cfo、paste、social-fetch）。整套东西底下只有一个想法：SKILL.md 就是技能本身——Markdown 就是工作流逻辑，没有构建步骤，迭代技能等于改文字，而任何人都能照着文档手动把步骤跑一遍，不必依赖那个把它自动化的宿主。所有个人数据都活在另一个配置目录里，只通过一个环境变量被找到，所以仓库里没有密钥、没有真实作品集、没有客户名字，可以放心 fork；二十一个技能加起来是 90 个文件、587 KB，全部由一个人写和维护。版本同时跑两条语义化线，一条给插件的发布标签，一条给单个技能，于是同一次发布里可以同时装着版本号完全不同的技能；技能之间按名字互相调用，被引用最多的是 watch-video、skillify 和 second-brain。整套东西真正的产物是文档：一个技能就是一份人也能读、能照着做的工作流说明。

谁做的这个仓库唯一的贡献者：71 次提交全部来自同一个账号 coreyhaines31，同一个名字、同一个邮箱，贡献者列表里再没有别人。其中 30 次提交带共同作者尾注并指名某个 Claude 模型——Fable 5 二十条、Opus 4.7 十条。README 结尾一行写他是 Conversion Factory 与 Magister 的创始人；他另有一个公开技能包 marketingskills，含 46 个营销技能，这里的 maker-council 就是从那个包的 marketing-council 改来的。

1. 01

   跑了十三周，然后安静了四周

   仓库建于 2026-06-03，同分钟的第一次提交就放下了插件清单、marketplace 条目和 README。今天还看得见的公开历史是被重写过的：ARCHITECTURE.md 记着 2026-06-28 用 git filter-repo 做的那次翻公开，把翻之前的个人数据从历史里全部抹掉；第一个 release v0.1.0 落在 2026-06-29，标题写着「first public release」。六天后，2026-07-06 一天里发了三个：v1.0.0 — Public launch、v1.0.1 — Fix SKILL.md frontmatter YAML、v1.1.0 — company-brain trust levels + /cb review。整条版本线很短——从 2026-06-29 到 2026-08-12，十六个 release、十六个 tag——其中六个的发布时间挤在 2026-07-01 的三十四秒内：v0.2.0 在 19:40:03，到 19:40:08 已经是 v0.5.0，接着 v0.5.1 和 v0.5.2 分别在 19:40:36 与 19:40:37。一条一次性冒出来的版本线，更像是事后把历史补上标签，而不是边写边发。最新的 release 是 2026-08-12 的 v1.5.0；可八月和九月的 pull request 里写着发了 v1.5.1、又把插件清单升到 1.6.0，这两个版本在 release 列表里都找不到。提交曲线说的是同一件事：总共 71 次，六月 36 次、七月 25 次、八月 9 次、九月 1 次，最后一次是 2026-09-04——本记录的四周之前。周围是 839 个星、69 个 fork、6 个 watcher、5 个开着的条目（三个 issue、两个 pull request），以及 MIT 许可下 587 KB 的文件。仓库没有归档，还有一个没合并的技能 pull request 挂在那里，所以本记录称它为 active，让那四周的空白自己说话。

2. 02

   文档优先，以及让它可被 fork 的两层结构

   解释整体形状的是 ARCHITECTURE.md，它开头就是一张两层图。公开层放 skills/*/SKILL.md 与 skills/*/references/*.md，并明确不含个人数据、密钥和真实作品集名；私有层是 ~/.config/makerskills/，被 gitignore，装着内容轮换的作品集、Typefully 工作区 ID、本地语气规则、看板配置、七个按技能分的归档目录，以及自选的评议会成员。技能只通过一个契约找到它：MAKERSKILLS_CONFIG，默认 $HOME/.config/makerskills；只有路径确实在别处时才加技能专属变量。整套按工种分成五个家族——元技能、决策与策略、知识与内容消化、产出与创意、运营与杂务——另有一节讲横跨它们的两种模式：个人与团队的同源兄弟（second-brain 对着 company-brain，personal-cfo 对着 company-cfo），以及那组扩展三件套。三件套身上带着仓库里最硬的一条规矩：「Rule of 3: the family stays at three. Resist Hookify / Configify / Memorify temptations.」组合关系是被量出来的，不是嘴上说的：同一份文件里有一张图，数每个技能被多少处兄弟上下文引用——watch-video 54、skillify 51、second-brain 48、slide-deck 38、company-brain 33、domain 32——采纳顺序也是从这些数字推出来的：先把中心技能配好，因为 watch-video 要 yt-dlp、ffmpeg 与 MLX-Whisper，而 second-brain 要一个 vault 路径。版本在这里是政策而不是习惯：两条语义化线，一条给插件标签、一条给单个技能，各自写明什么算 patch、什么算 minor、什么算 major，并直说 v0.5.0 的一次发布里可以同时装着 0.1.0、0.1.1、0.2.0 和 0.3.1 的技能。

3. 03

   那条 LinkedIn 私信，把用户状态搬出了安装目录

   issue 5 最能说明问题是怎么找到作者的：一份用户 bug 报告，走的是 LinkedIn 私信，来自 Cotopaxi Lyon，Lyon 的创始人。它其实是三份报告。第一份是数据丢失——五个技能把用户状态归档在自己的技能目录里，而 npx skills add 会从源头重新同步技能，于是下一次安装就把归档抹掉；issue 里带着一段四步复现，2026-07-10 用 skills CLI 1.5.15 跑的：装 decide、往它的归档目录写一个文件、重跑同一条安装命令，然后用户那个文件不见了，只剩仓库自带的索引。第二份是十六处性别代词，散在九个文件里，把用户称作 he。第三份是 slide-deck 模板把作者自己的身份写死了——页脚是 @coreyhaines · corey.co，默认目标也是他的站点——于是用户渲染出来的演示文稿可能带着别人的名号。三件事在同一个 pull request 里修完：归档搬到 ${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/<skill>/archive/，每个受影响的技能都加了一步尽力而为的迁移，好把活下来的旧归档带走，另有五个技能升到 0.2.0。写这次修复的过程中，同一类 bug 又在三个地方被翻出来——jab-hook 里的 Typefully social-set ID 与累积的模式、toolify 里用户存下的配方、pm 里的看板快照缓存。承载这次修复的 release 标题是 v1.2.0 — archives out of the install tree (user-state safety)：当一个缺陷被当成规矩而不是事故来对待时，看起来就是这个样子。

4. 04

   外面的两次报告，一次改了技能，一次还开着

   这里最有用的 issue 里，有两个讲的是「被陌生人指出问题」。2026-07-16，作者开了 issue 11，记录 @rabahrahil 在 X 上指出 decide 的问题集里没有机会成本这一问。核对写在 issue 里：37signals 那 38 问已经很接近——Q36 投入回报、Q37 更简单还是更难、Q20 会不会制造新工作——但从来没有直接问「答应这件事，等于放弃了什么」。修法比报告本身更小心：questions.md 里新开一节「House additions」，并明确标注这不是 37signals 的东西，好让借来的那套保持原样，Q39 就住在这里；同时把分诊表接上——涉及钱的决定走 Q36、Q38、Q39，重大的时间或注意力承诺单独一行。decide 升到 0.3.0，插件升到 v1.4.0，frontmatter 用 js-yaml 重新验过。第二个是 issue 2，开在 v1.0.1 修掉五个技能 description 里未加引号的冒号那一天：那处断裂在 skill 页面上被 GitHub 渲染成 YAML 报错横幅，而 Claude Code 宽松的解析器在本地把它藏了起来——发布当天就被用户抓到。issue 提议加一道持续集成守卫，严格解析每个技能的 frontmatter。它一直开着，直到 2026-08-10 一位叫 kasparovabi 的评论者把它变得更锋利：frontmatter 规范给 description 上限 1,024 字符、name 上限 64，而他是把值真数了一遍而不是目测——当时 main 上的十九个技能里有六个超限，company-brain 1,411 字符、skillify 1,267 字符。这也是全部讨论串里唯一一条不是作者本人写的评论。

5. 05

   先开 issue，和一个故意搁置的技能

   这一段时间里有两个技能是先提案、后动手。unstuck 来自 2026-07-15 的 issue 9，里面有一张分工表把它和邻居分开——decide 在已知选项之间选，business-brainstorm 评估一个生意点子，deep-research 收集外部信息，而这个技能是在看起来没有选项时造出选项；同一天还记下了前一天的决定：它必须对 agent 主动生效而不只是等人来喊，所以它的描述要在 agent 自己快要报「做不到」的时候触发。评议会走得更远。issue 1 开在 2026-07-02；成品以 pull request 13 的形式出现，标题上标着「DRAFT on purpose — do not merge until the unstuck launch has gone out」，搁置日期是 2026-07-15，2026-08-12 解除，同一天 v1.5.0 把它发了出去，并注明作者已同意发布。它的设计答案全都写了下来：八人长凳——Fried、Musk、Bezos、Jensen Huang、Iger、Graham、Naval、Blakely——按作者的说法是为了让视角互相撞车；按问题类型落座三到五人，并指定一名唱反调的人，理由是「an agreeing council is a mirror, not a board」；发言要落在各成员的档案文件上，那些档案经过了 Codex 两轮核验；可选的一次实时检索；一张分歧地图；以及主席综合，最后交棒给 decide。公开人物的档案随仓库发布，自选成员与会话归档住在配置目录里。发布它需要同步 README 与 changelog 里的目录，pull request 里写明了它推动的数字：十九个技能到二十个。

6. 06

   还开着的东西，和被移出去的东西

   快照拍下时还有两个 pull request 开着，而它们更像论证而不是补丁。第 30 号加的是 /radar：按计划轮询已知来源，把好的内容推进第二大脑；讨论串里记着它自己设计的两轮修订——v0.2.0 读完几个兄弟技能后绕开原先的局限，补上无需密钥的 Bluesky 与联邦宇宙实例接口；v0.3.0 则把付费抓取服务升为 X 与 LinkedIn 的主路径，因为作者真的调了那几个接口：花掉两个额度、还剩 22,195 个，并发现 X 的结果不按时间排——同一次调用先返回 2026-08-27，然后是 2024-08-19，再是 2025-06-15。它写下的取舍也很直白：每次运行只出一份摘要，只有高分条目自动入库；每个来源各存一份已见 ID 的状态文件，所以计划任务之后手动再跑一次也是安全的；打分只读元数据、抓正文另有一步。加进去的东西也不是全都留下了。vibecad——木工优先、把大白话变成 OpenSCAD 脚本并无头渲染四视图预览的对话式参数化 CAD 技能——在 2026-07-26 用 git filter-repo 连着完整历史抽到自己的私有仓库，并从树里删掉；issue 里用一句话记下这个判断：它不属于这个目录。这次搬动在发布流程上留了痕：main 上带着它的加入与移出，开发分支上没有，于是发布用的 pull request 14 冲突了，后来才有一个 pull request 把 main 合进来、把 changelog 对齐，v1.5.0 才发得出去。文档也会漂：README 数的是二十一个技能、表里有 ingest，而 ARCHITECTURE.md 还写着二十个，家族表里也没有 ingest 那一行。在这里，产品和它的文档是同一件东西，所以其中一个落后一个版本值得记下来。