skill-authoringlisted
Install: claude install-skill wlkerwong-boop/family-ai-skills
# Skill 编写规范 · 把方法论做成可触发的技能卡
**一句话**：在本机创建或修订技能的标准做法——frontmatter 触发词设计、正文固定骨架、单次写入 ≤~8K token（大内容拆成 SKILL.md 精华版 + references/ 全文版）、创建后必须验证注册成功。
## 什么时候触发
- 用户说"把这个做成 skill""写成技能""存为技能""沉淀下来"
- 需要把一篇文章、一套提示词、一个调试过程转化为可复用技能时
- 技能文件写入中途超时/截断，需要按正确姿势重写时
## 文件解剖（SKILL.md 标准骨架）
```yaml
---
name: <与目录名完全一致>
description: "Triggers: 中文触发词 / English triggers. 一句话能力描述。"
license: MIT
---
# 名称 · 一句话定位
**一句话**：这个技能干什么
## 什么时候触发
## 你的执行规则（编号、可执行、写给未来 AI 执行者）
## 可复制的完整提示词（如适用）
## 本机适配场景举例（绑定用户真实项目才算"适配"）
## 关联技能（工作流串联）
```
- description 开头放触发词；正文规则是操作指令，不是给人看的散文。
## 尺寸铁律（踩过坑，2026-08-24）
1. 单次工具调用的参数 ≤~8K token。超长内容一次 write_file 会流式中途超时、整个动作不执行。
2. 正确拆法：SKILL.md 只放精华操作版（目标 ≤~4KB）；逐字长文（完整提示词全文、原始资料、案例记录）放 `references/<名>.md`，SKILL.md 加一行指针。
3. 多文件批量任务：每次消息并行发 2 个中等 write_file，绝不单发巨型调用。
4. 被超时打断后不要原样重试同一大调用——先拆小再写。
## 验证闭环（写完必做）
1. shell 循环 `grep -m1 '^name:' ~/.hermes/skills/<s>/SKILL.md` 校验 frontmatter name 与目录名一致；
2. skill_view(name) 确认 readiness_status=available；
3. 带 references/ 的核对文件数量。
## 卡片族模式（一套方法论拆多张卡时）
- 每张卡一个独立技能（保证触发独立性）+ 一张总索引技能（选卡表、组合拳、出处 URL 存档）。
- 完整案例（12+1 卡实战、结构模板、教训）：见 `references/case-kazike-prompt-cards.md`。
## 多端分发（用户流程：先在 Hermes 跑项目验证，再装给其他 agent）
各 agent 技能目录（copytree 同步后逐一校验 SKILL.md + references 完整）：
| Agent | 路径 |
|---|---|
| Hermes | `~/.hermes/skills/<name>/` |
| Codex + Gemini CLI（共享） | `~/.agents/skills/<name>/` |
| Claude Code | `~/.claude/skills/<name>/` |
| DeepSeek Harness | `~/.dsh/skills/<name>/` |
| Kimi Code | `~/.kimi-code/skills/<name>/` |
-