Back to Details

skill-builder-playbook

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skill Builder Playbook

Skill Builder 实战指南

Create a high-quality skill by following a short workflow and pulling details from the references.
通过遵循简短的工作流程并参考相关文档细节，创建高质量的Skill。

Quick Start

快速入门

  1. Clarify the goal and use cases. See 
    references/planning-design.md
    .
  2. Decide if this is standalone or MCP-enhanced. See 
    references/fundamentals.md
    .
  3. Define structure and frontmatter. See 
    references/structure-and-frontmatter.md
    .
  4. Write the description field. See 
    references/description-field.md
    .
  5. Write concise instructions and examples. See 
    references/instruction-writing.md
    .
  6. Add references for details and variants. See 
    references/progressive-disclosure.md
    .
  7. Test and iterate. See 
    references/testing-iteration.md
    .
  8. Package and share. See 
    references/distribution-sharing.md
    .
  1. 明确目标和使用场景。参考
    references/planning-design.md
    。
  2. 确定该Skill是独立型还是MCP增强型。参考
    references/fundamentals.md
    。
  3. 定义结构和前置内容。参考
    references/structure-and-frontmatter.md
    。
  4. 编写描述字段。参考
    references/description-field.md
    。
  5. 编写简洁的说明和示例。参考
    references/instruction-writing.md
    。
  6. 添加用于说明细节和变体的参考文档。参考
    references/progressive-disclosure.md
    。
  7. 测试并迭代优化。参考
    references/testing-iteration.md
    。
  8. 打包并分享。参考
    references/distribution-sharing.md
    。

Guidance

指导原则

  • Keep SKILL.md short and link out to references.
  • Be specific and actionable; include error handling.
  • Avoid extra files (README/CHANGELOG) inside the skill folder unless explicitly requested.
  • 保持SKILL.md简洁，通过链接指向参考文档。
  • 内容需具体且可执行；包含错误处理相关内容。
  • 除非明确要求，否则不要在Skill文件夹内添加额外文件（如README/CHANGELOG）。

When To Read References

何时参考相关文档

  • Use 
    references/fundamentals.md
    for what skills are, progressive disclosure, and MCP + skills.
  • Use 
    references/planning-design.md
    for use cases, categories, and success criteria.
  • Use 
    references/structure-and-frontmatter.md
    for file layout, naming rules, and frontmatter requirements.
  • Use 
    references/description-field.md
    for description structure and good/bad examples.
  • Use 
    references/instruction-writing.md
    for instruction templates, best practices, and error handling.
  • Use 
    references/progressive-disclosure.md
    to split content into references without bloating SKILL.md.
  • Use 
    references/testing-iteration.md
    for testing modes, test cases, and iteration signals.
  • Use 
    references/distribution-sharing.md
    for packaging, API usage, and distribution guidance.
  • Use 
    references/patterns-troubleshooting.md
    for design patterns and debugging common issues.
  • Use 
    references/checklists.md
    for preflight and post-upload checks.
  • Use 
    references/resources-references.md
    for official docs, examples, and support.
  • 若想了解Skill是什么、渐进式披露以及MCP与Skill的结合，参考
    references/fundamentals.md
    。
  • 若想了解使用场景、分类和成功标准，参考
    references/planning-design.md
    。
  • 若想了解文件布局、命名规则和前置内容要求，参考
    references/structure-and-frontmatter.md
    。
  • 若想了解描述字段的结构及正反示例，参考
    references/description-field.md
    。
  • 若想了解说明模板、最佳实践和错误处理，参考
    references/instruction-writing.md
    。
  • 若想将内容拆分到参考文档中，避免SKILL.md过于冗长，参考
    references/progressive-disclosure.md
    。
  • 若想了解测试模式、测试用例和迭代信号，参考
    references/testing-iteration.md
    。
  • 若想了解打包、API使用和分发指南，参考
    references/distribution-sharing.md
    。
  • 若想了解设计模式和常见问题调试，参考
    references/patterns-troubleshooting.md
    。
  • 若想了解上传前和上传后的检查清单，参考
    references/checklists.md
    。
  • 若想了解官方文档、示例和支持资源，参考
    references/resources-references.md
    。