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 フィールド（最も重要）：

• スキルの目的とトリガー条件を明確に記述する
• 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}**: {간단한 설명} 

既存のスキルを参照

スキル	特徴
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 ファイルを変更するたびに、必ずバージョンを更新してください。

スキルの変更後：

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」（Semantic Versioning）か？

手動検証

スキルのインストールをテストします。

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