SuperAPI AI 工具集

skill builder

编程与开发

查看项目

更新于 10-16 14:35

技能介绍

用途

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 等额外字段会被忽略。
  • 关于收费、价格、平台支持范围或具体效果,资料未提供,暂未说明。