用途：skill-writer 用于帮助用户为 Gemini、Claude 和 Codex 设计、文档化和结构化 AI 智能体技能，目标是创建自包含、高效、能向 LLM 提供专业领域知识与流程指导的技能。
主要能力与原则：提出渐进式披露的三级加载机制——元数据（name + description，始终在上下文中，约 100 词，用于技能发现）、SKILL.md 正文（仅在技能触发时加载，少于 5k 词，含核心要求与工作流）、捆绑资源（按需加载，引用按需读取）。同时提出自由度分级：高自由度（文本，适合创意或多解法任务）、中自由度（伪代码，有偏好模式但允许变化）、低自由度（严格步骤，适合脆弱易错、需一致性的操作）。
目录结构：标准结构为 skill-name/ 下含 SKILL.md（入口，元数据加指令）、references/（可选，静态文档、schema 或大型指南）、assets/（可选，代码模板、样板或图片字体等静态文件）。references/ 用于偶尔才需要的知识，如 api_docs.md、finance_schema.md；assets/ 用于属于输出或产品的文件，如 logo.png、前端模板。
技能位置：按目标智能体放置——Gemini CLI 为 <project-root>/.gemini/skills/ 或 ~/.gemini/skills/；Claude Code 为 <project-root>/.claude/skills/ 或 ~/.claude/skills/；OpenAI Codex 为 <project-root>/.codex/skills/ 或 ~/.codex/skills/。
SKILL.md 写法：YAML frontmatter 必须含 name（唯一、kebab-case 标识）与 description（说明做什么、何时触发，是激活前唯一可见部分），可选 metadata 如 short-description。正文设计模式包括：高层指南加引用、按领域组织（避免上下文污染）、条件细节（简单编辑直接改，跟踪更改见引用）。
最佳实践：简洁（上下文窗口是公共资源，只补充智能体尚不具备的上下文）；样式优先遵循现有项目约定，再回退外部标准；可指示智能体激活其他技能；确保源材料每条规则都被提及或引用；以工作流为中心，尽早集成 lint、测试等质量检查。
创建流程：理解（确定用途与触发查询）、规划（识别可复用组件）、起草（写 frontmatter 起头的 SKILL.md 并应用渐进式披露）、验证（质量检查，详见 references/quality-checklist.md）。
限制：资料未提供收费、价格、平台支持细节或效果数据，暂未提供更多信息。