Back to Details

skill-creator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skill Creator

技能创建工具

Create new Claude Code skills following the official format and best practices.
按照官方格式与最佳实践创建新的Claude Code技能。

Quick Reference

快速参考

  • Structure Guide - Directory format and file organization
  • Naming Rules - Skill naming requirements
  • Description Guide - Writing effective descriptions
  • Templates - Process, knowledge, and tool skill templates
  • Examples - Complete skill creation walkthroughs
  • Validation - Commands to validate new skills
  • 结构指南 - 目录格式与文件组织
  • 命名规则 - 技能命名要求
  • 描述撰写指南 - 撰写高效的技能描述
  • 模板 - 流程类、知识类与工具类技能模板
  • 示例 - 完整的技能创建流程演示
  • 验证 - 验证新技能的命令

When to Use

适用场景

  • Creating a new reusable knowledge module
  • Adding specialized guidance for specific tasks
  • Building domain-specific expertise into Claude Code
  • Need to ensure proper skill format and structure
  • 创建新的可复用知识模块
  • 为特定任务添加专业指导
  • 为Claude Code构建特定领域专业能力
  • 需要确保技能格式与结构规范

Required SKILL.md Format

必备的SKILL.md格式

Every skill requires a 
SKILL.md
file with two parts:
  1. YAML frontmatter (metadata between 
    ---
    markers on line 1)
  2. Markdown instructions (guidance for Claude)
markdown
---
name: skill-name
description: Brief description of what this skill does and when to use it
---
每个技能都需要一个
SKILL.md
文件，包含两部分内容：
  1. YAML前置元数据（位于第一行
    ---
    标记之间的元数据）
  2. Markdown说明文档（给Claude的指导内容）
markdown
---
name: skill-name
description: Brief description of what this skill does and when to use it
---

Skill Title

Skill Title

Instructions

Instructions

Step-by-step guidance for Claude...
undefined
Step-by-step guidance for Claude...
undefined

YAML Frontmatter Fields

YAML前置元数据字段

FieldRequiredDescription
name
YesLowercase letters, numbers, hyphens only (max 64 chars). Must match directory name.
description
YesWhat the skill does and when to use it (max 1024 chars). Claude uses this to match requests.
allowed-tools
NoTools Claude can use without permission
model
NoSpecific model to use
context
NoSet to 
fork
for isolated sub-agent context
字段是否必填描述
name
是仅允许小写字母、数字、连字符（最多64字符）。必须与目录名称一致。
description
是说明技能功能与适用场景（最多1024字符）。Claude会用此字段匹配用户请求。
allowed-tools
否Claude无需授权即可使用的工具
model
否指定使用的模型
context
否设置为
fork
可启用独立的子Agent上下文

File Structure

文件结构

skill-name/
├── SKILL.md              # Required - overview and navigation
├── reference.md          # Detailed docs - loaded when needed
├── examples.md           # Usage examples - loaded when needed
└── scripts/
    └── helper.sh         # Utility script - executed, not loaded
skill-name/
├── SKILL.md              # 必填 - 概览与导航
├── reference.md          # 详细文档 - 按需加载
├── examples.md           # 使用示例 - 按需加载
└── scripts/
    └── helper.sh         # 实用脚本 - 可执行，不加载

Best Practices

最佳实践

  • Keep SKILL.md under 250 lines - Use progressive disclosure
  • Write specific descriptions - Include trigger terms users would naturally use
  • Link supporting files - From SKILL.md using markdown links
  • Validate structure - Check YAML syntax and file organization
See naming.md for naming conventions and templates.md for ready-to-use templates.
  • SKILL.md文件行数控制在250行以内 - 采用渐进式信息披露方式
  • 撰写具体的描述内容 - 包含用户会自然使用的触发词
  • 关联支持文件 - 在SKILL.md中使用Markdown链接
  • 验证结构规范 - 检查YAML语法与文件组织
请查看**naming.md了解命名规范，查看templates.md**获取即用型模板。