skill-creator

DaleStudy 的技能创建器

向 DaleStudy/skills 仓库添加新技能的指南。

技能结构

skills/{skill-name}/
└── SKILL.md          # YAML frontmatter + Markdown 지시사항 (필수)

SKILL.md 格式

---
name: skill-name # 필수: 디렉토리명과 일치 (최대 64자, 소문자/숫자/하이픈)
description: "스킬 설명" # 필수: 트리거 조건 포함 (최대 1024자)
license: MIT # 선택
compatibility: Required CLI tools # 선택: 필요한 도구
metadata: # 선택
  author: DaleStudy
  version: "1.0.0"
allowed-tools: Bash(command:*) # 선택: 허용할 도구 패턴
---
# 스킬 제목

스킬 지시사항 (Markdown)

技能创建流程

1. 创建目录

mkdir -p skills/{skill-name}

2. 编写 SKILL.md

Frontmatter 编写规则

name 字段：

• 必须与目录名相同
• 只能使用小写字母、数字和连字符
• 不可使用连续连字符（my--skill ❌）
• 最多 64 个字符

description 字段（最重要）：

• 清晰说明技能的用途和触发条件
• 正文只会在触发后加载，因此必须在 description 中说明“何时使用”
• 模式："{技能说明}。在以下情况下使用：(1) ...，(2) ...，(3) ..."

# ✅ 좋은 예
description: "Node.js 대신 Bun 런타임 사용을 위한 스킬. 다음 상황에서 사용: (1) 새 JavaScript/TypeScript 프로젝트 생성 시, (2) package.json 또는 의존성 관련 작업 시"

# ❌ 나쁜 예
description: "Bun 관련 스킬"  # 트리거 조건 없음

正文编写规则

• 保持简洁（建议不超过 500 行）
• 省略 Claude 已掌握的内容
• 优先使用代码示例，而非冗长说明
• 使用祈使句或不定式形式

3. 更新 README.md

在仓库根目录的 README.md 中添加新技能：

## Current Skills

- **bun**: Node.js 대신 Bun 런타임 사용
- **github-actions**: GitHub Actions 워크플로우 작성 및 보안
- **{new-skill}**: {간단한 설명} 

参考现有技能

技能	特点
bun	命令映射表，以代码示例为主
github-actions	安全最佳实践，以 YAML 示例为主
skill-creator	元技能、结构化流程、frontmatter 指南
storybook	CSF 3.0 最佳实践、TypeScript 类型示例

编写新技能时，请参考现有技能的风格，保持一致。

版本管理

遵循语义化版本（MAJOR.MINOR.PATCH），修改技能时更新版本：

MAJOR 版本（x.0.0）

不兼容变更——会影响现有用户：

• 添加或更改 Frontmatter 必填字段
• 缩减 allowed-tools 权限
• 大幅更改技能触发条件（修改 description）
• 引入与现有指令冲突的新规则

# 예: 1.2.3 → 2.0.0
metadata:
  version: "2.0.0"

MINOR 版本（0.x.0）

新增功能——保持向后兼容：

• 添加新的代码示例
• 添加指令章节（不与现有内容冲突）
• 扩大 allowed-tools 权限
• 扩展触发条件（保留现有条件）

# 예: 1.2.3 → 1.3.0
metadata:
  version: "1.3.0"

PATCH 版本（0.0.x）

错误修复和细微改进：

• 修正拼写错误
• 澄清说明（不改变含义）
• 整理代码示例格式
• 更新链接

# 예: 1.2.3 → 1.2.4
metadata:
  version: "1.2.4"

版本更新检查清单

CRITICAL：每次修改技能的 SKILL.md 文件时，都必须更新版本。

修改技能后：

1. 判断变更属于 MAJOR、MINOR 还是 PATCH
2. 更新 metadata.version 字段（必需）
3. [ ]（可选）编写 CHANGELOG.md（重大变更时）

未更新版本将被视为技能验证失败。

技能变更时的自动验证

IMPORTANT：修改 SKILL.md 文件时，务必检查以下内容：

1. 版本更新验证

如果修改了 SKILL.md 文件，也必须同时更新 metadata.version：

# 변경된 SKILL.md 확인
git diff --name-only HEAD | grep "skills/.*/SKILL.md"

# 또는 커밋 전 staged 파일 확인
git diff --cached --name-only | grep "skills/.*/SKILL.md"

# metadata.version 필드가 변경되었는지 확인
git diff HEAD -- skills/{skill-name}/SKILL.md | grep "^\+.*version:"
git diff --cached -- skills/{skill-name}/SKILL.md | grep "^\+.*version:"

# 변경되지 않았다면:
# ❌ ERROR: skills/{skill-name}/SKILL.md was modified but metadata.version was not updated
# Required: Update version according to Semantic Versioning (see 버전 관리 section above)

2. 版本递增方向验证

确认变更内容遵循正确的版本递增规则：

• MAJOR 变更却递增 MINOR/PATCH：❌ 错误
• MINOR 变更却递增 PATCH：⚠️ 警告
• PATCH 变更却递增 MINOR/MAJOR：✅ 允许（保守递增是安全的）

3. Frontmatter 有效性验证

• name 字段是否与目录名一致？
• description 字段是否包含触发条件？（“在以下情况下使用：”模式）
• metadata.version 格式是否为“X.Y.Z”（语义化版本）？

手动验证

测试技能安装：

npx skills add DaleStudy/skills --skill {skill-name} --agent claude-code --global --yes