DaleStudy技能创建指南：skill-creator使用教程与SEO优化

skill-creator by dalestudy/skills

237 周安装量

4 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/dalestudy/skills --skill 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 字段（最重要）:

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

4. 更新工作流矩阵

在 .github/workflows/ci.yml 的 matrix 中添加新技能：

matrix:
  skill:
    - bun
    - 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"

版本更新检查清单

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

判断更改属于 MAJOR/MINOR/PATCH 中的哪一类
更新 metadata.version 字段（必需）
（可选）编写 CHANGELOG.md（主要更改时）

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

技能更改时的自动验证

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

1. 版本更新验证

如果 SKILL.md 文件被修改，则 metadata.version 也必须一起更新：

# 检查更改的 SKILL.md
git diff --name-only HEAD | grep "skills/.*/SKILL.md"

# 或检查提交前的暂存文件
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:"

# 如果未更改：
# ❌ 错误：skills/{skill-name}/SKILL.md 已被修改但 metadata.version 未更新
# 要求：根据语义化版本控制更新版本（参见上面的版本管理部分）

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

🇺🇸English

Skill Creator for 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 필드 (가장 중요):

스킬의 목적과 트리거 조건 을 명확히 기술
Body는 트리거 후에만 로드되므로, "언제 사용"은 반드시 description에 포함
패턴: "{스킬 설명}. 다음 상황에서 사용: (1) ..., (2) ..., (3) ..."

✅ 좋은 예

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

❌ 나쁜 예

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

Body 작성 규칙

간결하게 유지 (500줄 이하 권장)
Claude가 이미 아는 내용은 생략
예제 코드 > 장황한 설명
명령형/부정사 형태 사용

3. README.md 업데이트

저장소 루트의 README.md에 새 스킬 추가:

## Current Skills

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

4. 워크플로우 매트릭스 업데이트

.github/workflows/ci.yml의 matrix에 새 스킬 추가:

matrix:
  skill:
    - bun
    - github-actions
    - { new-skill } # 추가

기존 스킬 참고

스킬	특징
`bun`	명령어 매핑 테이블, 코드 예제 중심
`github-actions`	보안 모범 사례, YAML 예제 중심
`skill-creator`	메타 스킬, 구조화된 절차, frontmatter 가이드
`storybook`	CSF 3.0 베스트 프랙티스, TypeScript 타입 예제

새 스킬 작성 시 기존 스킬의 스타일을 참고하여 일관성 유지.

버전 관리

Semantic Versioning (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 파일을 수정할 때마다 반드시 버전을 업데이트하세요.

스킬 수정 후:

변경 내용이 MAJOR/MINOR/PATCH 중 어디에 해당하는지 판단
metadata.version 필드 업데이트 (필수)
(선택) 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" (Semantic Versioning)인가?

수동 검증

스킬 설치 테스트:

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

Weekly Installs

201

Repository

dalestudy/skills

GitHub Stars

First Seen

Jan 25, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

claude-code187

github-copilot122

opencode114

codex113

gemini-cli113

cursor113

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

106,200 周安装