用途：skill-writer 是一份编写 Agent Skills 的攻略，帮助按官方 Agent Skills 规范创建、组织和记录技能。Agent Skills 被描述为一种开放格式，通过文件夹中的指令、脚本与资源为智能体赋予新能力，具有可移植、基于文件系统、模块化、无厂商锁定等特点。
主要能力与结构：每个技能独占一个目录，必需 SKILL.md，可选 scripts/、references/、assets/。SKILL.md 分两部分：顶部 YAML frontmatter 与 Markdown 正文。frontmatter 必填 name（小写、最多 64 字符、与文件夹名一致）和 description（最多 1024 字符，说明做什么、何时用）；可选 license、compatibility、metadata、allowed-tools（实验性）。正文建议包含 Overview、Quick Start、Main Instructions、Common Tasks、Examples、Troubleshooting、Reference 等分段。
使用方式与写作要点：指令需清晰、可扫读、含输入输出示例、保持聚焦（一个技能对应一个能力域，建议 5000 tokens 内），并提供可运行示例与错误处理。可选脚本应标注用途、加 shebang、chmod +x 后执行，如 chmod +x scripts/setup.sh 与 ./scripts/setup.sh。references 与 assets 用相对路径从技能根目录引用。
常见模式：任务导向（文件处理、系统管理、测试校验、代码生成）、领域知识（编程语言、框架库、API、最佳实践）、工作流（项目搭建、部署流程、评审清单、文档流程）。
命名与校验：使用小写加连字符的 kebab-case，避免大写、下划线、含糊缩写，文件夹名与技能名一致。完成前应校验 YAML 语法、逐步验证示例与路径、检查结构与相对路径。
限制：资料未提供价格、平台支持细节与具体效果数据；allowed-tools 被标注为实验性功能。可参考的规范、示例与社区链接以原始资料为准。