用途
Skill Builder 用于创建可在 Claude Code 等环境中被 Claude 自动发现并使用的 Skill。它围绕 SKILL.md 的规范格式、目录结构以及渐进式披露架构提供指引,适合从零构建新技能或整理已有技能内容。
主要能力
- 生成带规范 YAML frontmatter 的 SKILL.md,其中仅 name 和 description 为必需字段:name 最多 64 字符,description 最多 1024 字符,且 description 需同时说明“做什么”和“何时使用”。
- 支持渐进式披露架构:Level 1 为始终加载的名称与描述元数据,用于自动匹配;Level 2 为技能被触发后加载的 SKILL.md 正文;Level 3+ 为按需加载的引用文件、示例与模板。
- 提供目录组织指引:个人技能位于 ~/.claude/skills/[skill-name]/,项目技能位于 .claude/skills/[skill-name]/,并强调技能目录必须位于顶层,不支持嵌套子目录或命名空间。
- 提供 scripts/、resources/、docs/ 等可选目录的用途与引用方式,包括脚本执行、模板复制、示例与 schema 引用。
- 提供发布前校验清单,覆盖 YAML frontmatter、文件结构、内容质量、渐进式披露与测试。
- 提供三类模板:基础技能、中级技能(含脚本)、全功能高级技能,并给出安装、快速开始、配置、逐步指南、脚本参考等章节结构示例。
使用方式
先创建技能目录,例如:
mkdir -p ~/.claude/skills/my-first-skill
再创建包含 YAML frontmatter 与正文的 SKILL.md。资料给出的最小示例如下:
---
name: "My First Skill"
description: "Brief description of what this skill does and when Claude should use it. Maximum 1024 characters."
---
# My First Skill
## What This Skill Does
[Your instructions here]
## Quick Start
[Basic usage]
完成后重启 Claude Code 或刷新 Claude.ai 以验证技能是否被检测到。
适用场景
- 为个人工作流创建个人技能(放在 ~/.claude/skills/,不提交到 git)。
- 为团队创建可版本控制、提交到 git 的项目技能(放在项目根目录的 .claude/skills/)。
- 需要将大型参考内容拆分到 docs/、resources/、scripts/ 并仅在需要时加载的场景。
- 需要让技能描述具备清晰触发条件,以便 Claude 自主匹配使用。
限制
- 前置条件包括:Claude Code 2.0+ 或支持 Skills 的 Claude.ai,基本的 Markdown 与 YAML 知识,以及文本编辑器或 IDE。
- 技能目录必须直接位于 ~/.claude/skills/[skill-name]/ 或 .claude/skills/[skill-name]/ 下,Claude Code 不支持嵌套子目录或命名空间。
- Claude 只使用 name 与 description 字段,version、author、tags 等额外字段会被忽略。
- 关于收费、价格、平台支持范围或具体效果,资料未提供,暂未说明。