Karakuri (からくり) ——指精巧机关人偶，小而灵活，一上发条就自己动起来。这个仓库里的每个 skill 也是这样：独立、轻量、放进 agent 就能跑。
面向 Claude Code、Codex、Hermes、OpenClaw 等通用 Agent。每个 skill 是一个独立文件夹：SKILL.md 是核心指令，参考资料、模板和脚本放在同一目录下。不绑定特定 runtime；有额外依赖的会单独注明。
| Skill | 一句话定位 |
|---|---|
| coding-music | Claude Code干活时候可以播放音乐放松一下，弹窗确认事项和任务结束时自动暂停，待你确认处理后继续播放——帮助你把注意力放在最需要的地方 |
| coding-agent-fit | 当你想通过Agent接入一个新的产品或服务时，可以帮助你综合评测其对coding agent开发的友好程度，为你提供决策参考 |
| skill-triage-sibyl | Skill 装多了Agent调用就容易乱——这个skill可以帮你扫出功能定位重复、能力描述不准以及闲置吃灰的 skill，逐项给处置建议，在你授权后自动完成处理 |
git clone https://github.com/KKL08/Karakuri.git
# Claude Code
mkdir -p ~/.claude/skills
cp -r Karakuri/<skill-name> ~/.claude/skills/
# Codex
mkdir -p ~/.codex/skills
cp -r Karakuri/<skill-name> ~/.codex/skills/Hermes、OpenClaw 或其他 runtime：放到对应的 skill/plugin 目录，或作为 Markdown 指令包导入。skill 里的 agents/<runtime>.yaml、references/、scripts/ 需要和 SKILL.md 一起保留。
复制后，如果 agent 不会自动读取新 skill，重启对应 runtime。
/coding-music
用 Claude Code 写代码的日常是这样的：
Claude 在终端里噼里啪啦地输出，你可以靠在椅背上，趁这个空档听听歌、放松一下。 问题是，它随时可能刹一脚——要么弹个权限确认框，要么干完了当前任务等着你的进一步指令。
这时候你还沉浸在音乐播放中，注意力根本没法立刻集中到屏幕上的文字上。 经常会出现过了好一会才意识到需要进行操作，然后手忙脚乱地找暂停键，处理完授权，再手动把音乐点回来。
于是这个 Skill 诞生了。 它做的事特别简单：让你的注意力集中在更需要的地方，并替你节省来回切换音乐播放器的时间：
- 🧘 AI 干活时 → 音乐照常播放，你继续放松
- ⚡ AI 需要你的注意力时 → 音乐自动淡出 / 暂停
- ✅ 你处理完后 → 音乐自动回来
现在我的 Claude Code 节奏变成了——它输出，我放松；它提问，我专注。 切换无比自然，这才是 AI coding 该有的呼吸感。
安装和配置见 coding-music/README.md。
/coding-agent-fit https://resend.com/docs
你打算让 Claude Code、Codex 这类 Coding Agent 帮你接入一个新的产品或服务。但这个产品对 Agent 友好吗？Agent 能自己找到入口吗？quickstart 能跑通吗？会不会卡在拿 key 或者某个权限流程上？
以前只能让 Agent 先试试，卡了再排查。现在可以先跑个评测：
- 🔍 探测 → 自动扫 llms.txt、OpenAPI、MCP、CLI、SDK 等入口和辅助工具
- 🏃 实跑 → 选一条接入路径真走一遍，记录每步通过还是卡住
- 📊 出报告 → 双分数打分：基础达标 60 分及格线 + Agent 友好 40 分加分，一眼看出差在基础还是 Agent 投入
Coding Agent 的使用者可以用它做接入评估参考，产品或服务的提供方也可以拿来自查 Agent 友好度。
评分按站点类型分权重表，详见 coding-agent-fit/README.md。
/skill-triage-sibyl
Skill 装多了之后，agent 的调用准确度会明显往下掉。
你让它"帮我发个邮件"，它挑了一个只能搜邮件的 skill；你让它"整理一下笔记"，两个 skill 描述太像，它随机选了一个。更隐蔽的是，有些 skill 的描述里提到的覆盖范围和 SKILL.md 里不一致，过分夸大或者过于保守。
问题出在 description 本身，description 是 agent 决定是否调用 skill 的关键判断依据，所以其质量至关重要。但装了几十个之后靠人工逐个检查不现实。Sibyl Scope 替你做这件事：
- 🔍 扫描 → 列出所有 skill，统计 30 天调用频率，找出长期没用的
- 🩺 诊断 → 按五类问题逐项检查：描述太像、触发场景重叠、描述吹大了、描述写小了、定位没说清
- ✅ 处置 → 逐项让你选 archive / rewrite / keep / defer，确认后执行，所有动作一键回退
名字来自 PSYCHO-PASS 的 Sibyl System——它给市民的心理状态打分做分档处置，这个给 skill 的描述质量打分做清理建议。不同的是，决定权在你。