Dami-Randle Skill Writer Skill 技能
Claude Code 专属 Skill 创建工作流模板
Dami-Randle Skill Writer 是一套面向 Claude Code 用户的 Agent Skill 创作工作流模板。它把"写一个可复用的 AI 技能"拆解为范围界定、前置元数据、结构化示例、验证激活、故障排查五个固定环节，帮助作者一次性产出可被 agent 自动发现、按意图稳定触发的 SKILL.md 文档。
核心能力
- 范围定义引导：要求作者先明确单一能力边界，避免把多个不相关的工作流塞进同一个 skill。
- frontmatter 规则：列出 SKILL.md 必须包含的字段、命名约束以及触发描述的撰写要求。
- 目录结构示例：区分个人 skill（
~/.claude/skills/）与项目 skill（.claude/skills/）的放置方式。 - Markdown 结构模板：提供指令段、示例段、参考段的写法范式，便于 agent 渐进式加载。
- 验证与测试清单：覆盖 frontmatter 校验、目录名校验、激活测试、错误回退等多步骤检查。
- 常见故障诊断：包括 skill 不触发、触发过宽、文件位置错误、依赖未声明等典型问题排查路径。
- 单文件与多文件模式：分别给出最小可用 skill 与复杂 skill 的代码骨架。
安装配置
- 通过 npm 安装：
npx skillstore add dami-randle/skill-writer，适合本地调试与个人使用。 - 将
.claude/skills/skill-writer/拷贝到目标项目根目录.claude/skills/下，适合团队内共享。 - 配合
Makefile、mise.toml或本地脚本用于 CI 中跑 frontmatter lint 校验。
使用步骤
- 描述你想做的工作流（输入、输出、目标用户、典型触发语），作者在 SKILL.md 中填入 name 与 description。
- 选定放置路径（个人或项目），按 frontmatter 规则补齐 name、description、allowed-tools 等必填字段。
- 在正文中按"指令 / 示例 / 参考"分段写指令，先给最小可用版本，再追加高级细节。
- 用 prompt 模板"Review my SKILL.md frontmatter..."自检 name 与 description 的合法性与触发清晰度。
- 跑一遍激活测试（"Help me create a Claude Code skill for X"），确认 agent 在真实对话中正确加载该 skill。
- 若触发失败，运行 prompt 模板"My Claude Code skill does not activate for relevant requests"定位问题。
- 把验证结果写进 commit 或 PR 描述里，便于团队审阅与回滚。
适用场景
- 团队内部多次重复的工作流（如 PR 模板生成、release note 撰写、issue triage）需要沉淀为可复用 skill。
- 把过去的 prompt、checklist、流程文档转换成有 frontmatter 的 SKILL.md，降低新人上手成本。
- 为开源项目贡献者准备统一的 skill 写作规范，避免每个 PR 风格差异。
- 排查已有 skill 的激活问题（不触发、误触发、加载超时），通过清单逐项定位。
- 平台团队为多个项目维护共享 skill 库，统一 frontmatter、命名、参考目录的写法。
适用人群
- 负责 Claude Code 工作流落地的工程师与平台 SRE。
- 需要给团队成员准备"AI 工具箱"的 Tech Lead。
- 经常写 prompt 但希望沉淀为 skill 的独立开发者。
- 负责审阅 skill 仓库质量的 Maintainer 与 Reviewer。
工作原理
skill 在被加载时由 Claude Code 的 skill 索引器扫描 .claude/skills//SKILL.md，读取 name 与 description 字段作为检索关键词；当用户输入与 description 描述的意图匹配时，agent 会把 SKILL.md 内容注入上下文，并按其中"指令 / 示例 / 参考"的顺序执行。该 skill 通过固化"先范围、再 frontmatter、再内容、最后验证"的流程，让作者产出符合 Claude Code 加载规范的技能文档，并通过自带的清单减少触发失败的概率。
官方链接
团队信息
AI产品库
官方
由 AI 猎手自动发现
评论与建议
登录 后参与评论或提建议