用途
skill-builder-generic 是一个通用指南,用于创建生产级 Claude Code 技能(Skills)。技能是结构化的知识包,用于扩展 Claude Code 在特定领域的能力。该指南帮助用户把领域知识(如设计系统、API 模式、部署工作流)打包成可复用、可按名称调用、可渐进加载的技能。
主要能力
- 提供 6 步创建流程:理解需求、规划结构、初始化技能、编辑内容、打包与验证、迭代与改进。
- 定义技能的标准化格式:YAML frontmatter 元数据 + Markdown 指令内容,可选 references/、scripts/、assets/ 目录用于捆绑资源。
- 支持渐进式披露(Progressive Disclosure)以优化上下文:SKILL.md 始终加载,references/ 按需加载,scripts/ 在执行时加载。
- 提供 4 种组织模式:工作流型(顺序步骤)、任务型(独立操作)、参考/指南型(标准与规范)、能力型(多入口集成功能套件)。
- 提供 5 分钟快速上手流程,用于创建最小可用技能。
- 提供验证清单,涵盖 YAML frontmatter(12 项检查)、文件结构(10 项检查)、内容质量(10 项检查)。
- 提供配套脚本:init-skill.py(初始化)、validate-skill.py(验证结构)、analyze-description.py(分析描述触发效果)、package-skill.sh(打包分发)。
使用方式
手动创建技能目录与 SKILL.md:
mkdir -p .claude/skills/skill-name
cat > .claude/skills/skill-name/SKILL.md <<'EOF'
---
name: skill-name
description: [What it does]. Use when [triggers].
---
# Skill Name
## Overview
[Purpose in 1-2 sentences]
## Quick Start
[Basic usage]
EOF
mkdir -p .claude/skills/skill-name/references
mkdir -p .claude/skills/skill-name/scripts
使用脚本初始化:
python scripts/init-skill.py skill-name --template workflow
python scripts/init-skill.py skill-name --interactive
验证与打包:
python scripts/validate-skill.py skill-name/
python scripts/analyze-description.py skill-name/
bash scripts/package-skill.sh skill-name/
YAML frontmatter 模板:
---
name: skill-name-in-hyphen-case
description: [What skill does in 1-2 sentences]. [Key features]. Use when [trigger scenarios with keywords].
---
描述公式为:What(主要用途)+ Features(关键能力,可选)+ Triggers(触发场景与关键词)。
适用场景
适合创建技能的情况:需要沉淀领域特定知识(设计系统、API 模式、部署工作流);频繁重复相似指令(测试模式、代码审查标准);希望与团队或社区共享知识;需要一致地执行复杂工作流。
不适合创建技能的情况:信息仅一次性使用;任务更适合在对话中内联处理;知识变化过快难以维护。
限制
- 资料未提供该技能的收费、价格、平台支持范围或实际效果数据。
- 资料未提供脚本的具体实现细节、依赖环境或运行前提。
- 资料未提供技能的版本历史、维护状态或社区规模。
- 资料未提供除 Claude Code 之外的其他平台兼容性说明。