Back to Details

skill-creator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skill Creator for DaleStudy

DaleStudy技能创建指南

DaleStudy/skills 저장소에 새로운 스킬을 추가하기 위한 가이드.
用于在DaleStudy/skills仓库中添加新技能的指南。

스킬 구조

技能结构

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

SKILL.md 형식

SKILL.md格式

yaml
---
name: skill-name # 필수: 디렉토리명과 일치 (최대 64자, 소문자/숫자/하이픈)
description: "스킬 설명" # 필수: 트리거 조건 포함 (최대 1024자)
license: MIT # 선택
compatibility: Required CLI tools # 선택: 필요한 도구
metadata: # 선택
  author: DaleStudy
  version: "1.0.0"
allowed-tools: Bash(command:*) # 선택: 허용할 도구 패턴
---
yaml
---
name: skill-name # 必填：与目录名称一致（最多64字符，小写/数字/连字符）
description: "技能说明" # 必填：包含触发条件（最多1024字符）
license: MIT # 可选
compatibility: Required CLI tools # 可选：所需工具
metadata: # 可选
  author: DaleStudy
  version: "1.0.0"
allowed-tools: Bash(command:*) # 可选：允许的工具模式
---

스킬 제목

技能标题

스킬 지시사항 (Markdown)
undefined
技能说明（Markdown）
undefined

스킬 생성 절차

技能创建流程

1. 디렉토리 생성

1. 创建目录

bash
mkdir -p skills/{skill-name}
bash
mkdir -p skills/{skill-name}

2. SKILL.md 작성

2. 编写SKILL.md

Frontmatter 작성 규칙

Frontmatter编写规则

name 필드:
  • 디렉토리명과 동일해야 함
  • 소문자, 숫자, 하이픈만 사용
  • 연속된 하이픈 불가 (
    my--skill
    ❌)
  • 최대 64자
description 필드 (가장 중요):
  • 스킬의 목적과 트리거 조건을 명확히 기술
  • Body는 트리거 후에만 로드되므로, "언제 사용"은 반드시 description에 포함
  • 패턴: 
    "{스킬 설명}. 다음 상황에서 사용: (1) ..., (2) ..., (3) ..."
yaml
undefined
name字段:
  • 必须与目录名称一致
  • 仅使用小写字母、数字和连字符
  • 不允许连续连字符（
    my--skill
    ❌）
  • 最多64字符
description字段（最重要）:
  • 明确描述技能的目的和触发条件
  • 正文仅在触发后加载，因此“何时使用”必须包含在description中
  • 格式：
    "{技能说明}。在以下场景中使用：(1) ..., (2) ..., (3) ..."
yaml
undefined

✅ 좋은 예

✅ 示例

description: "Node.js 대신 Bun 런타임 사용을 위한 스킬. 다음 상황에서 사용: (1) 새 JavaScript/TypeScript 프로젝트 생성 시, (2) package.json 또는 의존성 관련 작업 시"
description: "用于替代Node.js使用Bun运行时的技能。在以下场景中使用：(1) 创建新JavaScript/TypeScript项目时，(2) 处理package.json或依赖相关操作时"

❌ 나쁜 예

❌ 反例

description: "Bun 관련 스킬" # 트리거 조건 없음
undefined
description: "Bun相关技能" # 无触发条件
undefined

Body 작성 규칙

正文编写规则

  • 간결하게 유지 (500줄 이하 권장)
  • Claude가 이미 아는 내용은 생략
  • 예제 코드 > 장황한 설명
  • 명령형/부정사 형태 사용
  • 保持简洁（建议500行以内）
  • 省略Claude已了解的内容
  • 优先使用代码示例而非冗长说明
  • 使用命令式/不定式语态

3. README.md 업데이트

3. 更新README.md

저장소 루트의 README.md에 새 스킬 추가:
markdown
undefined
在仓库根目录的README.md中添加新技能：
markdown
undefined

Current Skills

Current Skills

  • bun: Node.js 대신 Bun 런타임 사용
  • github-actions: GitHub Actions 워크플로우 작성 및 보안
  • {new-skill}: {간단한 설명} <!-- 추가 -->
undefined
  • bun: 替代Node.js使用Bun运行时
  • github-actions: GitHub Actions工作流编写及安全
  • {new-skill}: {简短说明} <!-- 新增 -->
undefined

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

4. 更新工作流矩阵

.github/workflows/ci.yml
의 matrix에 새 스킬 추가:
yaml
matrix:
  skill:
    - bun
    - github-actions
    - { new-skill } # 추가
在
.github/workflows/ci.yml
的matrix中添加新技能：
yaml
matrix:
  skill:
    - bun
    - github-actions
    - { new-skill } # 新增

기존 스킬 참고

参考现有技能

스킬특징
bun
명령어 매핑 테이블, 코드 예제 중심
github-actions
보안 모범 사례, YAML 예제 중심
skill-creator
메타 스킬, 구조화된 절차, frontmatter 가이드
storybook
CSF 3.0 베스트 프랙티스, TypeScript 타입 예제
새 스킬 작성 시 기존 스킬의 스타일을 참고하여 일관성 유지.
技能特点
bun
以命令映射表、代码示例为核心
github-actions
以安全最佳实践、YAML示例为核心
skill-creator
元技能、结构化流程、Frontmatter指南
storybook
CSF 3.0最佳实践、TypeScript类型示例
编写新技能时参考现有技能的风格，保持一致性。

버전 관리

版本管理

Semantic Versioning (MAJOR.MINOR.PATCH)을 따라 스킬 수정 시 버전 업데이트:
遵循语义化版本（Semantic Versioning, MAJOR.MINOR.PATCH），修改技能时更新版本：

MAJOR 버전 (x.0.0)

MAJOR版本 (x.0.0)

호환성이 깨지는 변경 - 기존 사용자에게 영향:
  • Frontmatter 필수 필드 추가/변경
  • allowed-tools
    권한 축소
  • 스킬 트리거 조건 대폭 변경 (description 수정)
  • 기존 지시사항과 상충되는 새 규칙 도입
yaml
undefined
不兼容变更 - 影响现有用户：
  • 添加/修改Frontmatter必填字段
  • 缩小
    allowed-tools
    权限
  • 大幅修改技能触发条件（修改description）
  • 引入与现有说明冲突的新规则
yaml
undefined

예: 1.2.3 → 2.0.0

示例: 1.2.3 → 2.0.0

metadata: version: "2.0.0"
undefined
metadata: version: "2.0.0"
undefined

MINOR 버전 (0.x.0)

MINOR版本 (0.x.0)

새 기능 추가 - 하위 호환 유지:
  • 새로운 예제 코드 추가
  • 지시사항 섹션 추가 (기존과 충돌 없음)
  • allowed-tools
    권한 확대
  • 트리거 조건 확장 (기존 조건 유지)
yaml
undefined
新增功能 - 保持向下兼容：
  • 添加新的代码示例
  • 添加说明章节（与现有内容无冲突）
  • 扩大
    allowed-tools
    权限
  • 扩展触发条件（保留原有条件）
yaml
undefined

예: 1.2.3 → 1.3.0

示例: 1.2.3 → 1.3.0

metadata: version: "1.3.0"
undefined
metadata: version: "1.3.0"
undefined

PATCH 버전 (0.0.x)

PATCH版本 (0.0.x)

버그 수정 및 사소한 개선:
  • 오타 수정
  • 설명 명확화 (의미 변경 없음)
  • 코드 예제 포맷 정리
  • 링크 업데이트
yaml
undefined
Bug修复和小改进:
  • 修正拼写错误
  • 明确说明（不改变含义）
  • 整理代码示例格式
  • 更新链接
yaml
undefined

예: 1.2.3 → 1.2.4

示例: 1.2.3 → 1.2.4

metadata: version: "1.2.4"
undefined
metadata: version: "1.2.4"
undefined

버전 업데이트 체크리스트

版本更新检查清单

CRITICAL: 스킬 SKILL.md 파일을 수정할 때마다 반드시 버전을 업데이트하세요.
스킬 수정 후:
  1. 변경 내용이 MAJOR/MINOR/PATCH 중 어디에 해당하는지 판단
  2. metadata.version
    필드 업데이트 (필수)
  3. (선택) CHANGELOG.md 작성 (주요 변경 시)
버전 미업데이트는 스킬 검증 실패로 간주됩니다.
重要提示：每次修改技能的SKILL.md文件时，必须更新版本。
修改技能后：
  1. 判断变更属于MAJOR/MINOR/PATCH中的哪一类
  2. 更新
    metadata.version
    字段（必填）
  3. （可选）编写CHANGELOG.md（重大变更时）
未更新版本将被视为技能验证失败。

스킬 변경 시 자동 검증

修改技能时的自动验证

IMPORTANT: SKILL.md 파일을 수정할 때, 반드시 다음을 확인하세요:
重要提示：修改SKILL.md文件时，请务必检查以下内容：

1. 버전 업데이트 검증

1. 版本更新验证

SKILL.md 파일이 수정되었다면 
metadata.version
도 함께 업데이트되어야 합니다:
bash
undefined
若SKILL.md文件被修改，
metadata.version
也必须同时更新：
bash
undefined

변경된 SKILL.md 확인

查看已修改的SKILL.md

git diff --name-only HEAD | grep "skills/.*/SKILL.md"
git diff --name-only HEAD | grep "skills/.*/SKILL.md"

또는 커밋 전 staged 파일 확인

或查看提交前的暂存文件

git diff --cached --name-only | grep "skills/.*/SKILL.md"
git diff --cached --name-only | grep "skills/.*/SKILL.md"

metadata.version 필드가 변경되었는지 확인

检查metadata.version字段是否已修改

git diff HEAD -- skills/{skill-name}/SKILL.md | grep "^+.*version:" git diff --cached -- skills/{skill-name}/SKILL.md | grep "^+.*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

❌ 错误: skills/{skill-name}/SKILL.md已修改但metadata.version未更新

Required: Update version according to Semantic Versioning (see 버전 관리 section above)

要求: 根据语义化版本更新版本（见上方版本管理章节）

undefined
undefined

2. 버전 증가 방향 검증

2. 版本升级方向验证

변경된 내용이 올바른 버전 증가를 따르는지 확인:
  • MAJOR 변경인데 MINOR/PATCH 증가: ❌ 에러
  • MINOR 변경인데 PATCH 증가: ⚠️ 경고
  • PATCH 변경인데 MINOR/MAJOR 증가: ✅ 허용 (보수적 증가는 안전)
检查变更内容是否遵循正确的版本升级规则：
  • MAJOR变更但升级为MINOR/PATCH: ❌ 错误
  • MINOR变更但升级为PATCH: ⚠️ 警告
  • PATCH变更但升级为MINOR/MAJOR: ✅ 允许（保守升级更安全）

3. Frontmatter 유효성 검증

3. Frontmatter有效性验证

  • name
    필드가 디렉토리명과 일치하는가?
  • description
    필드가 트리거 조건을 포함하는가? ("다음 상황에서 사용:" 패턴)
  • metadata.version
    형식이 "X.Y.Z" (Semantic Versioning)인가?
  • name
    字段是否与目录名称一致？
  • description
    字段是否包含触发条件？（“在以下场景中使用：”格式）
  • metadata.version
    格式是否为“X.Y.Z”（语义化版本）？

수동 검증

手动验证

스킬 설치 테스트:
bash
npx skills add DaleStudy/skills --skill {skill-name} --agent claude-code --global --yes
技能安装测试：
bash
npx skills add DaleStudy/skills --skill {skill-name} --agent claude-code --global --yes