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"

バージョン更新チェックリスト

重要: スキル SKILL.md ファイルを修正するたびに、必ずバージョンを更新してください。

スキル修正後:

1. 変更内容が MAJOR/MINOR/PATCH のどれに該当するか判断
2. metadata.version フィールドを更新 (必須)
3. (オプション) CHANGELOG.md を作成 (主要な変更時)

バージョン未更新はスキル検証失敗と見なされます。

スキル変更時の自動検証

重要: 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
# 必須: Semantic Versioning に従ってバージョンを更新してください (上記のバージョン管理セクションを参照)

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