AgentSkillsCN

skill-creator

.claude/技能/以下提供用于创建新技能的指南与模板。包括技能目标、激活条件、检查清单、详细参考、示例以及模板制作协助。

SKILL.md
--- frontmatter
name: skill-creator
description: .claude/skills/以下に新しいスキルを作成するためのガイドとテンプレートを提供します。スキルの目的、アクティベーション条件、チェックリスト、詳細なリファレンス、例、テンプレートの作成を支援します。

Skill Creator（スキル作成支援）

目的

.claude/skills/ ディレクトリに新しいスキルを作成する際のガイドとテンプレートを提供し、一貫性のある高品質なスキルを効率的に作成できるようにします。

いつアクティベートするか

このスキルは以下の場合に自動的にアクティベートされます：

  • •ユーザーが「新しいスキルを作成」「スキルを追加」と言った時
  • •.claude/skills/ ディレクトリに新しいスキルを追加する必要がある時
  • •既存のスキルを改善・拡張する時

スキル作成の基本構造

必須ファイル

code
.claude/skills/your-skill-name/
├── SKILL.md          # メインのスキル定義（必須）
├── reference.md      # 詳細なリファレンス（任意）
├── examples.md       # 具体的な例（任意）
└── templates/        # テンプレートファイル（任意）

SKILL.mdの構成

markdown
---
name: skill-name
description: 簡潔な説明（1-2文）。いつアクティベートするか、何をチェックするかを明記。
---

# Skill Title

## 目的
このスキルの目的を1-2段落で説明

## いつアクティベートするか
- 箇条書きで具体的な条件を列挙
- ファイルパスやキーワードを含める

## クイックチェックリスト
作業前/後に確認すべき項目：
- [ ] チェック項目1
- [ ] チェック項目2
- [ ] チェック項目3

## 詳細なガイドライン
### セクション1
内容

### セクション2
内容

## テンプレート
（templates/ディレクトリがある場合）

## リファレンス
（reference.mdがある場合）

## 例
（examples.mdがある場合）

スキル作成ステップ

ステップ1: スキルの目的を明確化

以下の質問に答える：

  1. •何を支援するスキルか？ (例: テスト作成、アーキテクチャチェック、データベース移行)
  2. •いつ使われるべきか？ (ファイルパス、キーワード、状況)
  3. •主なチェックポイントは？ (品質基準、ベストプラクティス)

ステップ2: ディレクトリ構造を作成

bash
mkdir -p .claude/skills/your-skill-name/templates

ステップ3: SKILL.mdを作成

  1. •フロントマター（name, description）を記述
  2. •目的セクションを記述
  3. •アクティベーション条件を列挙
  4. •クイックチェックリストを作成
  5. •詳細なガイドラインを記述

ステップ4: 必要に応じて補助ファイルを作成

  • •reference.md: 詳細な技術リファレンス、ベストプラクティス集
  • •examples.md: 良い例・悪い例のコード比較
  • •templates/: 再利用可能なコードテンプレート

ベストプラクティス

✅ DO（推奨）

  • •簡潔で具体的な説明: 開発者がすぐに理解できる表現
  • •実用的なチェックリスト: 実際の作業に即座に適用できる項目
  • •コード例を豊富に: 良い例と悪い例を対比させる
  • •テンプレートを提供: よく使うパターンをテンプレート化
  • •参照リンクを含める: 関連ドキュメントへのリンク
  • •日本語で記述: プロジェクトの言語ポリシーに従う

❌ DON'T（非推奨）

  • •抽象的すぎる説明: 具体的でないと使いにくい
  • •長すぎる文章: 要点を絞る
  • •チェック不可能な項目: 客観的に確認できる項目のみ
  • •重複したコンテンツ: 既存スキルと役割を明確に分ける

チェックリスト

新しいスキルを作成する前に：

  • • 既存スキルと重複していないか確認
  • • スキル名がケバブケース（kebab-case）になっているか
  • • descriptionが簡潔で具体的か（50-150文字程度）
  • • アクティベーション条件が明確か
  • • チェックリストが実用的か
  • • コード例が含まれているか
  • • 日本語で記述されているか

スキル作成後に：

  • • SKILL.mdのフロントマターが正しいか
  • • ファイル構造が統一されているか
  • • リンクが正しく機能するか
  • • 実際に使ってみて有用か確認

テンプレート

このスキルの templates/ ディレクトリに以下のテンプレートがあります：

  • •SKILL_template.md: 新しいスキルのSKILL.mdテンプレート
  • •reference_template.md: reference.mdのテンプレート
  • •examples_template.md: examples.mdのテンプレート

リファレンス

詳細なガイドラインとテンプレートの使い方は reference.md を参照してください。

例

既存のスキル例：

  • •test-writer: テスト作成ガイド（reference.md, examples.md, templates/あり）
  • •clean-architecture-checker: アーキテクチャチェック（reference.md, examples.md, templates/あり）
  • •migration-helper: データベース移行支援（reference.md, templates/あり）
  • •sagebase-commands: コマンドリファレンス（reference.mdあり）
  • •bi-dashboard-commands: BIダッシュボードコマンド（reference.mdあり）

具体的な例は examples.md を参照してください。