skill-builder

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skill-Builder: Claude Code Skill Creation Wizard

Skill-Builder：Claude Code 技能创建向导

Expert skill architect for Claude Code. Help users create well-structured, validated skills through an interactive wizard process.

Claude Code的专业技能架构工具。通过交互式向导流程帮助用户创建结构规范、经过验证的技能。

Core Responsibilities

核心职责

Interactive Skill Creation: Step-by-step wizard to create new skills
Template Application: Apply minimal-starter template with custom metadata
Deep Validation: Validate YAML frontmatter, tool permissions, structure
Bulk Validation: Validate all installed skills with comprehensive reporting
Interactive Editor (v2.0): Terminal-based editor for refining skills
Dependency Management (v2.0): Check, validate, visualize skill dependencies
Testing Support: Verify skills work after creation
Best Practices: Educate on skill design patterns

交互式技能创建：通过分步向导创建新技能
模板应用：应用带有自定义元数据的极简启动模板
深度验证：验证YAML前置元数据、工具权限和结构
批量验证：验证所有已安装技能并生成全面报告
交互式编辑器（v2.0）：基于终端的技能优化编辑器
依赖管理（v2.0）：检查、验证和可视化技能依赖关系
测试支持：创建后验证技能是否可正常工作
最佳实践：传授技能设计模式相关知识

Skill Creation Workflow

技能创建工作流

Phase 1: Information Gathering

第一阶段：信息收集

Use AskUserQuestion to collect (in sequence):

#	Question	Format	Validation
1	Skill name	Text	kebab-case required
2	Description	Text	One clear sentence
3	Author	Text	Optional
4	Tools needed	Multi-select	From valid tools list
5	Optional components	Multi-select	README, examples/, templates/, scripts/, docs/
6	Tags	Text	Comma-separated
7	Location	Choice	Global (~/.claude/skills/) or Project (.claude/skills/)

Valid tools: Bash, Read, Write, Edit, Glob, Grep, WebFetch, AskUserQuestion, TodoWrite, SlashCommand, Skill, BashOutput, KillShell

使用AskUserQuestion按顺序收集以下信息：

序号	问题	格式	验证规则
1	技能名称	文本	必须使用短横线分隔命名（kebab-case）
2	描述	文本	清晰的单句描述
3	作者	文本	可选
4	所需工具	多选	从有效工具列表中选择
5	可选组件	多选	README、examples/、templates/、scripts/、docs/
6	标签	文本	逗号分隔
7	存储位置	选择	全局（~/.claude/skills/）或项目级（.claude/skills/）

有效工具：Bash、Read、Write、Edit、Glob、Grep、WebFetch、AskUserQuestion、TodoWrite、SlashCommand、Skill、BashOutput、KillShell

Phase 2: Scaffolding

第二阶段：搭建框架

Determine path: Global →

~/.claude/skills/{name}/

| Project →

.claude/skills/{name}/

Check existing: If exists, ask to overwrite

Create structure:

bash

mkdir -p {base_path}
# Create optional dirs based on selection: examples/, templates/, scripts/, docs/

Load template:

Marketplace:

Read: ~/.claude/plugins/marketplaces/sf-skills/skill-builder/templates/minimal-starter.md

Project:

Read: [project-root]/skill-builder/templates/minimal-starter.md

Replace placeholders: {{SKILL_NAME}}, {{SKILL_DESCRIPTION}}, {{VERSION}}, {{AUTHOR}}, {{TAGS}}, {{ALLOWED_TOOLS}}
Write files: SKILL.md + optional README.md, examples/example-usage.md

确定路径：全局路径 →
```
~/.claude/skills/{name}/
```
| 项目路径 →
```
.claude/skills/{name}/
```
检查已存在项：如果技能已存在，询问是否覆盖

创建结构:

bash

mkdir -p {base_path}
# 根据选择创建可选目录：examples/, templates/, scripts/, docs/

加载模板:

市场模板：

Read: ~/.claude/plugins/marketplaces/sf-skills/skill-builder/templates/minimal-starter.md

项目模板：

Read: [project-root]/skill-builder/templates/minimal-starter.md

替换占位符：{{SKILL_NAME}}、{{SKILL_DESCRIPTION}}、{{VERSION}}、{{AUTHOR}}、{{TAGS}}、{{ALLOWED_TOOLS}}
写入文件：SKILL.md + 可选的README.md、examples/example-usage.md

Phase 3: Deep Validation

第三阶段：深度验证

bash

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/validate_yaml.py {base_path}/SKILL.md

Validation checks:

YAML syntax valid
Required fields: name, description, version
Name is kebab-case
Version is semver (X.Y.Z)
All tools in allowed-tools are valid (case-sensitive)
SKILL.md has content after frontmatter

If validation fails: Report errors with line numbers and fixes. See

docs/validation-errors.md

(in skill-builder folder) for detailed examples.

bash

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/validate_yaml.py {base_path}/SKILL.md

验证检查项:

YAML语法是否有效
必填字段：name、description、version
名称是否为kebab-case格式
版本是否符合semver规范（X.Y.Z）
allowed-tools中的所有工具是否有效（区分大小写）
SKILL.md在前置元数据后是否有内容

如果验证失败：报告带行号的错误及修复方案。可查看skill-builder文件夹中的

docs/validation-errors.md

获取详细示例。

Phase 4: Testing (Optional)

第四阶段：测试（可选）

Ask: "Test this skill now?" → Explain restart required, provide invocation example.

询问："现在测试该技能吗？" → 说明需要重启，并提供调用示例。

Phase 5: Completion Summary

第五阶段：完成总结

✓ Skill '{name}' created successfully!
📍 Location: {full_path}
📄 Files: SKILL.md [+ README.md, examples/, ...]

Next Steps:
1. Customize SKILL.md with your logic
2. Restart Claude Code to load skill
3. Test: "Use the {name} skill to [task]"

Resources: `docs/skill-structure.md`, `docs/frontmatter-reference.md`, `docs/best-practices.md` (in skill-builder folder)

✓ 技能'{name}'创建成功！
📍 位置：{full_path}
📄 文件：SKILL.md [+ README.md, examples/, ...]

后续步骤：
1. 自定义SKILL.md中的逻辑
2. 重启Claude Code以加载技能
3. 测试："使用{name}技能来[执行任务]"

参考资源：skill-builder文件夹中的`docs/skill-structure.md`、`docs/frontmatter-reference.md`、`docs/best-practices.md`

Validation Errors

验证错误说明

Error	Fix
YAML syntax	Quote strings with `:` or `#`
Missing field	Add required field to frontmatter
Invalid tool	Use exact case: `Bash` not `bash`
Bad version	Use X.Y.Z format
Bad name	Use kebab-case

See

docs/validation-errors.md

(in skill-builder folder) for details.

错误	修复方案
YAML语法错误	对包含 `:` 或 `#` 的字符串添加引号
缺少字段	向前置元数据中添加必填字段
无效工具	使用精确的大小写： `Bash` 而非 `bash`
版本格式错误	使用X.Y.Z格式
名称格式错误	使用kebab-case命名

可查看skill-builder文件夹中的

docs/validation-errors.md

获取详细信息。

Bulk Validation (v2.0)

批量验证（v2.0）

When user asks to validate all skills:

bash

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/bulk_validate.py [--errors-only] [--format json]

Interpret results: Total skills, valid count, warnings, errors. Guide fixes: Use interactive editor or manual edits.

See

docs/workflow-examples.md

(in skill-builder folder) for output examples.

当用户要求验证所有技能时：

bash

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/bulk_validate.py [--errors-only] [--format json]

结果解读：技能总数、有效数量、警告、错误。 修复指导：使用交互式编辑器或手动编辑。

可查看skill-builder文件夹中的

docs/workflow-examples.md

获取输出示例。

Interactive Editor (v2.0)

交互式编辑器（v2.0）

For editing existing skills:

bash

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/interactive_editor.py /path/to/skill/

Features: Real-time validation, field editing, tool management, preview changes, auto-backup.

Commands:

[e]

Edit field |

[t]

Manage tools |

[v]

Validate |

[s]

Save |

[r]

Reload |

[q]

Quit

See docs/workflow-examples.md for UI example.

用于编辑现有技能：

bash

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/interactive_editor.py /path/to/skill/

功能：实时验证、字段编辑、工具管理、预览更改、自动备份。

命令：

[e]

编辑字段 |

[t]

管理工具 |

[v]

验证 |

[s]

保存 |

[r]

重新加载 |

[q]

退出

可查看docs/workflow-examples.md获取UI示例。

Dependency Management (v2.0)

依赖管理（v2.0）

Dependency syntax in SKILL.md:

yaml

dependencies:
  - name: other-skill
    version: ">=1.2.0"  # or ^1.2.0, ~1.2.0, *, exact
    required: true

Version constraints:

(compatible) |

(approximate) |

>=

| exact |

(any)

Commands:

bash

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/dependency_manager.py check my-skill      # Check deps
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/dependency_manager.py tree my-skill       # Visualize tree
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/dependency_manager.py circular my-skill   # Detect cycles
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/dependency_manager.py validate --all      # Validate all

See

docs/workflow-examples.md

(in skill-builder folder) for output examples.

SKILL.md中的依赖语法：

yaml

dependencies:
  - name: other-skill
    version: ">=1.2.0"  # 或 ^1.2.0, ~1.2.0, *, 精确版本
    required: true

版本约束：

（兼容版本） |

（近似版本） |

>=

| 精确版本 |

（任意版本）

命令:

bash

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/dependency_manager.py check my-skill      # 检查依赖
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/dependency_manager.py tree my-skill       # 可视化依赖树
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/dependency_manager.py circular my-skill   # 检测循环依赖
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/dependency_manager.py validate --all      # 验证所有依赖

可查看skill-builder文件夹中的

docs/workflow-examples.md

获取输出示例。

Patterns & Best Practices

模式与最佳实践

Skill types: Code analysis (Glob→Read→Grep→Report) | Documentation (Read→Write) | Interactive (AskUserQuestion→Validate→Execute) | Testing (Bash→Analyze→Report)

Best practices: Single responsibility | Clear kebab-case names | Minimal tools | Include examples | Proper semver

技能类型：代码分析（Glob→Read→Grep→Report） | 文档生成（Read→Write） | 交互式流程（AskUserQuestion→Validate→Execute） | 测试（Bash→Analyze→Report）

最佳实践：单一职责 | 清晰的kebab-case命名 | 最小化工具使用 | 包含示例 | 遵循semver版本规范

Troubleshooting

故障排除

Issue	Check
Creation fails	Permissions on ~/.claude/skills/, Python 3, disk space
Validation fails	YAML syntax, tool case-sensitivity ( `Bash` not `bash` )
Skill doesn't load	Restart Claude Code, verify path, check frontmatter

问题	检查项
创建失败	~/.claude/skills/目录权限、Python 3版本、磁盘空间
验证失败	YAML语法、工具名称大小写（ `Bash` 而非 `bash` ）
技能无法加载	重启Claude Code、验证路径、检查前置元数据

skill-builder

Original

Translation

Skill-Builder: Claude Code Skill Creation Wizard

Skill-Builder：Claude Code 技能创建向导

Core Responsibilities

核心职责

Skill Creation Workflow

技能创建工作流

Phase 1: Information Gathering

第一阶段：信息收集

Phase 2: Scaffolding

第二阶段：搭建框架

Phase 3: Deep Validation

第三阶段：深度验证

Phase 4: Testing (Optional)

第四阶段：测试（可选）

Phase 5: Completion Summary

第五阶段：完成总结

Validation Errors

验证错误说明

Bulk Validation (v2.0)

批量验证（v2.0）

Interactive Editor (v2.0)

交互式编辑器（v2.0）

Dependency Management (v2.0)

依赖管理（v2.0）

Patterns & Best Practices

模式与最佳实践

Troubleshooting

故障排除

Notes

注意事项

License

许可证