关于 skill-builder
skill-builder 按照官方规范和编写实践指导创建 Agent Skills，适合需要设计、生成和检查技能的作者。它提供从明确范围到验证结构并测试行为的分步流程。
主要功能
- 01明确用途、范围和触发词
- 02规划结构与渐进式披露
- 03生成带 frontmatter 的 SKILL.md
- 04依据规范和实践进行验证
- 05测试触发与行为
适用场景
- 01根据明确用途起草新的 Agent Skill
- 02检查技能的元数据和文件结构
- 03用有代表性的提示词测试技能
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/skill-builder确认已加载。
附带文件examples.mdreference.md
详细介绍
技能构建器
用途
按照官方规范和最佳实践创建可用于生产环境的 Agent Skills。
激活时机
当你提到以下内容时，我会自动加载：
- “构建技能”或“创建技能”
- “生成技能”或“制作技能”
- “设计技能”或“新建技能”
权威参考资料（请先阅读）
创建任何技能之前，请先阅读以下文档的当前版本：
- Agent Skills Specification（开放标准）： https://agentskills.io/specification
- Skill Authoring Best Practices（Anthropic）： https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices
- Claude Code Skills Documentation（Claude Code 扩展）： https://docs.claude.com/en/docs/claude-code/skills
- Example Skills（参考实现）： https://github.com/anthropics/skills
这些是权威依据。如果本技能中的任何内容与这些文档相矛盾，应以官方文档为准。
我的工作内容
分 5 个步骤创建技能：
- 澄清 → 定义用途、范围和激活关键词
- 设计 → 规划结构，决定渐进式披露方式
- 生成 → 创建具有适当 frontmatter 和正文的 SKILL.md
- 验证 → 对照规范和最佳实践进行检查
- 测试 → 验证激活和行为
Frontmatter（Agent Skills 规范）
只需两个必填字段：
---
name: my-skill
description: What this skill does and when to use it. Include specific keywords for discovery.
---
可选字段：license、compatibility、metadata、allowed-tools。
Claude Code 还支持：disable-model-invocation、user-invocable、model、
context、agent、hooks、argument-hint。
不要使用：version（请改用 metadata.version）、auto_activates、
priority_score、source_urls、evaluation_criteria、invokes、
philosophy、maturity——这些字段都不受任何运行时识别。
关键最佳实践
摘自官方最佳实践：
简洁性
- Claude 已经很聪明，只添加它尚不具备的上下文。
- 逐段审视：“这段内容值得消耗这些令牌吗？”
- SKILL.md 正文少于 500 行。
描述质量
- 使用第三人称撰写（“处理 Excel 文件”，而不是“我来帮你”）
- 同时说明技能的功能和适用时机
- 包含具体的触发关键词，以便发现技能
- 最多 1024 个字符
渐进式披露
- 启动时加载元数据（仅名称和描述）
- 技能激活时加载 SKILL.md
- 仅在需要时加载支持文件
- 从 SKILL.md 到参考资料最多保持一层深度
自由度
- 高自由度：存在多种有效方法，取决于具体情境
- 中自由度：存在首选模式，也允许一定变化
- 低自由度：操作易出错，必须严格遵循确切顺序
不包含时效性内容
- 不要写“截至今日”“最近添加”“v3.0 中新增”等内容
- 如需提供历史背景，请使用“旧模式”一节
反馈循环
- 运行验证器 → 修复错误 → 重复
- 对关键操作加入验证步骤
验证清单
✅ Frontmatter：包含有效的 name 和 description
✅ 名称：小写，仅使用连字符，长度为 1–64 个字符，并与目录名称一致
✅ 描述：长度为 1–1024 个字符，采用第三人称，并包含触发关键词
✅ 正文：少于 500 行
✅ 参考资料：从 SKILL.md 到参考资料最多一层深度
✅ 无过时内容：不包含时间相关表述
✅ 术语一致：每个概念始终使用同一个术语
✅ 经过测试：至少适用于 3 个有代表性的提示词
支持文件
- reference.md：详细模式、架构和验证规则
- examples.md：技能创建工作流和示例