skill-writer

Skill Writer 用于创建和优化 Claude Skills，遵循最佳实践和校验规则。核心原则：上下文稀缺，只补充 Claude 不知道的内容；描述决定技能何时加载，必须写触发条件而非工作流摘要；采用三级渐进式加载（元数据约 100 tokens 始终加载 → SKILL.md 正文约 5000 tokens 触发时加载 → references/scripts/assets 按需加载）；frontmatter 描述用英文以便可靠触发，正文可用目标读者语言；硬约束用 MUST、NEVER、CRITICAL RULE；信息只放 SKILL.md 或 references 之一，不重复。技能类型包括 Reference、Pattern、Migration、Discipline。创建流程：定义使用范围（通用/用户/项目/单一用例）、编写 frontmatter（name 为小写 kebab-case、1-64 字符且与目录同名；description 用 "Use when..." 单行英文小于 500 字符）、编写指令（角色设定、diff 对比、错误排查表）、组织资源（SKILL.md 接近 500 行或约 5000 tokens 时拆分，references 仅一层深度，超过 100 行加目录）、校验。校验命令：just lint-skills、just fix-skills、just update-readme。目录结构包含 SKILL.md（必需）、references/、scripts/、assets/，不包含 README 等辅助文档。外部技能记录在 skills/skills.json，流程为添加条目 → just update-skills → just update-readme。具体安装方式与价格暂未提供。