Back to Details

skill-builder

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skill Builder

Skill 构建器

Purpose

用途

Helps users create production-ready Claude Code skills that follow best practices from official Anthropic documentation and amplihack's ruthless simplicity philosophy.
帮助用户创建符合Anthropic官方文档最佳实践以及amplihack“极致简洁”理念的生产级Claude Code技能。

When I Activate

激活时机

I automatically load when you mention:
  • "build a skill" or "create a skill"
  • "generate a skill" or "make a skill"
  • "design a skill" or "develop a skill"
  • "skill builder" or "new skill"
  • "skill for [purpose]"
当你提及以下内容时，我会自动加载：
  • "构建技能"或"创建技能"
  • "生成技能"或"制作技能"
  • "设计技能"或"开发技能"
  • "Skill Builder"或"新技能"
  • "skill for [具体用途]"

What I Do

功能说明

I orchestrate the skill creation process using amplihack's specialized agents:
  1. Clarify Requirements (prompt-writer agent)
    • Understand skill purpose and scope
    • Define target users and use cases
    • Identify skill type (agent, command, scenario)
  2. Design Structure (architect agent)
    • Plan YAML frontmatter fields
    • Design skill organization (single vs multi-file)
    • Calculate token budget allocation
    • Choose appropriate templates
  3. Generate Skill (builder agent)
    • Create SKILL.md with proper YAML frontmatter
    • Write clear instructions and examples
    • Include supporting files if needed
    • Follow progressive disclosure pattern
  4. Validate Quality (reviewer agent)
    • Check YAML frontmatter syntax
    • Verify token budget (<5,000 tokens core)
    • Ensure philosophy compliance (>85% score)
    • Test description quality for discovery
  5. Create Tests (tester agent)
    • Define activation test cases
    • Create edge case validations
    • Document expected behaviors
我会通过amplihack的专用Agent编排技能创建流程：
  1. 需求明确（prompt-writer agent）
    • 理解技能的用途和范围
    • 定义目标用户和使用场景
    • 确定技能类型（agent、command、scenario）
  2. 结构设计（architect agent）
    • 规划YAML前置元数据字段
    • 设计技能组织架构（单文件 vs 多文件）
    • 计算令牌预算分配
    • 选择合适的模板
  3. 技能生成（builder agent）
    • 创建包含正确YAML前置元数据的SKILL.md文件
    • 编写清晰的说明和示例
    • 按需添加配套文件
    • 遵循渐进式披露模式
  4. 质量验证（reviewer agent）
    • 检查YAML前置元数据语法
    • 验证令牌预算（核心部分<5000令牌）
    • 确保符合理念要求（得分>85%）
    • 测试描述质量以提升可发现性
  5. 创建测试用例（tester agent）
    • 定义激活测试用例
    • 创建边缘场景验证
    • 记录预期行为

Skill Types Supported

支持的技能类型

  • skill: Claude Code skills in 
    ~/.amplihack/.claude/skills/
    (auto-discovery)
  • agent: Specialized agents in 
    ~/.amplihack/.claude/agents/amplihack/specialized/
  • command: Slash commands in 
    ~/.amplihack/.claude/commands/amplihack/
  • scenario: Production tools in 
    ~/.amplihack/.claude/scenarios/
See examples.md for detailed examples of each type.
  • skill：存储在
    ~/.amplihack/.claude/skills/
    目录下的Claude Code技能（支持自动发现）
  • agent：存储在
    ~/.amplihack/.claude/agents/amplihack/specialized/
    目录下的专用Agent
  • command：存储在
    ~/.amplihack/.claude/commands/amplihack/
    目录下的斜杠命令
  • scenario：存储在
    ~/.amplihack/.claude/scenarios/
    目录下的生产工具
查看examples.md获取每种类型的详细示例。

Command Interface

命令接口

For explicit invocation:
bash
/amplihack:skill-builder <skill-name> <skill-type> <description>
Examples in examples.md.
如需显式调用：
bash
/amplihack:skill-builder <skill-name> <skill-type> <description>
示例请参考examples.md。

Documentation

文档

Supporting Files (progressive disclosure):
  • reference.md: Architecture, patterns, YAML spec, best practices
  • examples.md: Real-world usage, testing, troubleshooting
Original Documentation Sources (embedded in reference.md):
  1. Official Claude Code Skills: https://code.claude.com/docs/en/skills
  2. Anthropic Agent SDK Skills: https://docs.claude.com/en/docs/agent-sdk/skills
  3. Agent Skills Engineering Blog: https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
  4. Claude Cookbooks - Skills: https://github.com/anthropics/claude-cookbooks/tree/main/skills
  5. Skills Custom Development Notebook: https://github.com/anthropics/claude-cookbooks/blob/main/skills/notebooks/03_skills_custom_development.ipynb
  6. metaskills/skill-builder (Reference): https://github.com/metaskills/skill-builder
All documentation is embedded in reference.md for offline access. Links provided for updates and verification.
Note: This skill automatically loads when Claude detects skill building intent. For explicit control, use 
/amplihack:skill-builder
.
配套文件（渐进式披露）：
  • reference.md：架构、模式、YAML规范、最佳实践
  • examples.md：实际使用、测试、故障排除
原始文档来源（已嵌入reference.md）：
  1. 官方Claude Code技能文档：https://code.claude.com/docs/en/skills
  2. Anthropic Agent SDK技能文档：https://docs.claude.com/en/docs/agent-sdk/skills
  3. Agent技能工程博客：https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
  4. Claude 技能食谱：https://github.com/anthropics/claude-cookbooks/tree/main/skills
  5. 技能自定义开发笔记本：https://github.com/anthropics/claude-cookbooks/blob/main/skills/notebooks/03_skills_custom_development.ipynb
  6. metaskills/skill-builder（参考实现）：https://github.com/metaskills/skill-builder
所有文档均已嵌入reference.md以支持离线访问。提供的链接用于获取更新和验证。
注意：当Claude检测到技能构建意图时，本技能会自动加载。如需显式控制，请使用
/amplihack:skill-builder
命令。