skill-creator

目的

Anthropic の公式ベストプラクティスに従い、手動設定なしで新しい CLI スキルを作成することです。このスキルは、ブレーンストーミング、テンプレート適用、検証、インストールプロセスを自動化しながら、プログレッシブディスクロージャーパターンとライティングスタイル標準を維持します。

このスキルを使う場合

このスキルは以下の場合に使用してください:

• ユーザーが CLI 機能をカスタム機能で拡張したい
• ユーザーが公式標準に従うスキルを作成する必要がある
• ユーザーが反復的な CLI タスクを再利用可能なスキルで自動化したい
• ユーザーがドメイン知識をスキル形式にパッケージ化したい
• ユーザーがローカルおよびグローバルのスキルインストールオプション両方を必要としている

コア機能

1. インタラクティブなブレーンストーミング - スキルの目的とスコープを定義する協調セッション
2. プロンプト拡張 - prompt-engineer スキルとの統合（オプション）
3. テンプレート適用 - 標準化されたテンプレートからの自動ファイル生成
4. 検証 - Anthropic 標準に基づく YAML、コンテンツ、スタイルチェック
5. インストール - ローカルリポジトリまたはシンボリックリンクによるグローバルインストール
6. 進捗追跡 - 各ステップで完了状況を表示する視覚的なゲージ

ステップ 0: 発見

スキル作成を開始する前に、実行時情報を収集します:

# 利用可能なプラットフォームの検出
COPILOT_INSTALLED=false
CLAUDE_INSTALLED=false
CODEX_INSTALLED=false

if command -v gh &>/dev/null && gh copilot --version &>/dev/null 2>&1; then
    COPILOT_INSTALLED=true
fi

if [[ -d "$HOME/.claude" ]]; then
    CLAUDE_INSTALLED=true
fi

if [[ -d "$HOME/.codex" ]]; then
    CODEX_INSTALLED=true
fi

# 作業ディレクトリの決定
REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
SKILLS_REPO="$REPO_ROOT"

# cli-ai-skills リポジトリ内かどうかを確認
if [[ ! -d "$SKILLS_REPO/.github/skills" ]]; then
    echo "⚠️  Not in cli-ai-skills repository. Creating standalone skill."
    STANDALONE=true
fi

# git config からユーザー情報を取得
AUTHOR=$(git config user.name || echo "Unknown")
EMAIL=$(git config user.email || echo "")

必要な主要情報:

• サポート対象のプラットフォーム (Copilot、Claude、Codex、またはすべて)
• インストール設定 (ローカル、グローバル、または両方)
• スキル名と目的
• スキルタイプ (一般的、コード、ドキュメンテーション、分析)

メインワークフロー

進捗追跡ガイドライン

ワークフロー全体を通じて、各フェーズを開始する前に視覚的な進捗バーを表示して、ユーザーに情報を提供します。進捗バーのフォーマットは:

[████████████░░░░░░] 60% - Step 3/5: Creating SKILL.md

フォーマット仕様:

• 20 文字幅 (填済み部分は █、未填済み部分は ░)
• 現在のステップに基づくパーセンテージ (ステップ 1=20%、ステップ 2=40%、ステップ 3=60%、ステップ 4=80%、ステップ 5=100%)
• ステップカウンター表示 (例: "Step 3/5")
• 現在のフェーズの簡潔な説明

以下を使用して進捗バーを表示:

echo "[████░░░░░░░░░░░░░░] 20% - Step 1/5: Brainstorming & Planning"

フェーズ 1: ブレーンストーミング & 計画

進捗: このフェーズを開始する前に表示:

echo "[████░░░░░░░░░░░░░░] 20% - Step 1/5: Brainstorming & Planning"

進捗を表示:

╔══════════════════════════════════════════════════════════════╗
║     🛠️  SKILL CREATOR - Creating New Skill                  ║
╠══════════════════════════════════════════════════════════════╣
║ → Phase 1: Brainstorming                 [10%]               ║
║ ○ Phase 2: Prompt Refinement                                 ║
║ ○ Phase 3: File Generation                                   ║
║ ○ Phase 4: Validation                                        ║
║ ○ Phase 5: Installation                                      ║
╠══════════════════════════════════════════════════════════════╣
║ Progress: ███░░░░░░░░░░░░░░░░░░░░░░░░░░░  10%              ║
╚══════════════════════════════════════════════════════════════╝

ユーザーに以下を質問:

1. このスキルで何ができるようにしたいですか? (自由形式の説明)

   • 例: "ユーザーが Python コードをスタックトレース分析でデバッグするのを手助けする"

2. いつトリガーすべきですか? (3-5 個のトリガーフレーズを指定)

   • 例: "debug Python error"、"analyze stack trace"、"fix Python exception"

3. このスキルのタイプは何ですか?

   • 一般的な目的 (デフォルトテンプレート)
   • コード生成/変更
   • ドキュメンテーション作成/保守
   • 分析/調査

4. どのプラットフォームをサポートすべきですか?

   • GitHub Copilot CLI
   • Claude Code
   • Codex
   • 3 つすべて (推奨)

5. 1 文の説明を提供してください (メタデータに表示されます)

   • 例: "Python スタックトレースを分析して修正を提案します"

レスポンスをキャプチャして、次のフェーズを準備します。

フェーズ 2: プロンプト拡張 (オプション)

進捗: このフェーズを開始する前に表示:

echo "[████████░░░░░░░░░░] 40% - Step 2/5: Prompt Enhancement"

進捗を更新:

╔══════════════════════════════════════════════════════════════╗
║ ✓ Phase 1: Brainstorming                                     ║
║ → Phase 2: Prompt Refinement             [30%]               ║
╠══════════════════════════════════════════════════════════════╣
║ Progress: █████████░░░░░░░░░░░░░░░░░░░░░  30%              ║
╚══════════════════════════════════════════════════════════════╝

ユーザーに質問: "prompt-engineer スキルを使用してスキル説明を改善しますか?"

• はい - prompt-engineer を使用して明確性と構造を向上させる
• いいえ - 現在の説明で進める

はいの場合:

1. prompt-engineer スキルが利用可能かどうかを確認
2. 現在の説明を入力として呼び出す
3. 拡張された出力をユーザーとレビュー
4. 質問: "拡張版を受け入れるか、元のバージョンを保持しますか?"

いいえまたはprompt-engineer が利用できない場合:

• 元のユーザー入力を進める

フェーズ 3: ファイル生成

進捗: このフェーズを開始する前に表示:

echo "[████████████░░░░░░] 60% - Step 3/5: File Generation"

進捗を更新:

╔══════════════════════════════════════════════════════════════╗
║ ✓ Phase 1: Brainstorming                                     ║
║ ✓ Phase 2: Prompt Refinement                                 ║
║ → Phase 3: File Generation               [50%]               ║
╠══════════════════════════════════════════════════════════════╣
║ Progress: ███████████████░░░░░░░░░░░░░░░  50%              ║
╚══════════════════════════════════════════════════════════════╝

スキル構造を生成:

# スキル名をケバブケースに変換
SKILL_NAME=$(echo "$USER_INPUT" | tr '[:upper:]' '[:lower:]' | tr ' ' '-')

# ディレクトリを作成
if [[ "$PLATFORM" =~ "copilot" ]]; then
    mkdir -p ".github/skills/$SKILL_NAME"/{references,examples,scripts}
fi

if [[ "$PLATFORM" =~ "claude" ]]; then
    mkdir -p ".claude/skills/$SKILL_NAME"/{references,examples,scripts}
fi

if [[ "$PLATFORM" =~ "codex" ]]; then
    mkdir -p ".codex/skills/$SKILL_NAME"/{references,examples,scripts}
fi

テンプレートを適用:

1. SKILL.md - 適切なテンプレートを使用:

   • skill-template-copilot.md、skill-template-claude.md、または skill-template-codex.md
   • プレースホルダーを置換:
     • {{SKILL_NAME}} → ケバブケース名
     • {{DESCRIPTION}} → 1 行の説明
     • {{TRIGGERS}} → カンマ区切りのトリガーフレーズ
     • {{PURPOSE}} → ブレーンストーミングからの詳細な目的
     • {{AUTHOR}} → git config から
     • {{DATE}} → 現在の日付 (YYYY-MM-DD)
     • {{VERSION}} → "1.0.0"

2. README.md - readme-template.md を使用:

   • ユーザーファーシング資料 (300-500 語)
   • インストール手順を含める
   • 使用例を追加

3. References/ (オプションだが推奨):

   • detailed-guide.md を拡張資料として作成 (2k-5k 語)
   • 長めのコンテンツをここに移動して SKILL.md を 2k 単語以下に保つ

ファイル作成コマンド:

# テンプレートを置換と共に適用
sed "s/{{SKILL_NAME}}/$SKILL_NAME/g; \
     s/{{DESCRIPTION}}/$DESCRIPTION/g; \
     s/{{AUTHOR}}/$AUTHOR/g; \
     s/{{DATE}}/$(date +%Y-%m-%d)/g" \
    resources/templates/skill-template-copilot.md \
    > ".github/skills/$SKILL_NAME/SKILL.md"

# README を作成
sed "s/{{SKILL_NAME}}/$SKILL_NAME/g" \
    resources/templates/readme-template.md \
    > ".github/skills/$SKILL_NAME/README.md"

# Codex が選択されている場合、テンプレートを適用
if [[ "$PLATFORM" =~ "codex" ]]; then
    sed "s/{{SKILL_NAME}}/$SKILL_NAME/g; \
         s/{{DESCRIPTION}}/$DESCRIPTION/g; \
         s/{{AUTHOR}}/$AUTHOR/g; \
         s/{{DATE}}/$(date +%Y-%m-%d)/g" \
        resources/templates/skill-template-codex.md \
        > ".codex/skills/$SKILL_NAME/SKILL.md"
    
    sed "s/{{SKILL_NAME}}/$SKILL_NAME/g" \
        resources/templates/readme-template.md \
        > ".codex/skills/$SKILL_NAME/README.md"
fi

作成されたストラクチャーを表示:

✅ Created:
   .github/skills/your-skill-name/ (Copilot が選択されている場合)
   .claude/skills/your-skill-name/ (Claude が選択されている場合)
   .codex/skills/your-skill-name/ (Codex が選択されている場合)
   ├── SKILL.md (832 lines)
   ├── README.md (347 lines)
   ├── references/
   ├── examples/
   └── scripts/

フェーズ 4: 検証

進捗: このフェーズを開始する前に表示:

echo "[████████████████░░] 80% - Step 4/5: Validation"

進捗を更新:

╔══════════════════════════════════════════════════════════════╗
║ ✓ Phase 3: File Generation                                   ║
║ → Phase 4: Validation                    [70%]               ║
╠══════════════════════════════════════════════════════════════╣
║ Progress: █████████████████████░░░░░░░░░  70%              ║
╚══════════════════════════════════════════════════════════════╝

検証スクリプトを実行:

# YAML frontmatter を検証
scripts/validate-skill-yaml.sh ".github/skills/$SKILL_NAME"

# コンテンツ品質を検証
scripts/validate-skill-content.sh ".github/skills/$SKILL_NAME"

予想される出力:

🔍 Validating YAML frontmatter...
✅ YAML frontmatter valid!

🔍 Validating content...
✅ Word count excellent: 1847 words
✅ Content validation complete!

検証に失敗した場合:

• 具体的なエラーを表示
• 自動的に修正することを提案 (一般的な問題)
• ユーザーに複雑な問題を手動で修正するよう依頼

一般的な自動修正:

• 二人称を命令形に変換
• 説明を三人称に再フォーマット
• 欠落している必須フィールドを追加

フェーズ 5: インストール

進捗: このフェーズを開始する前に表示:

echo "[████████████████████] 100% - Step 5/5: Installation"

進捗を更新:

╔══════════════════════════════════════════════════════════════╗
║ ✓ Phase 4: Validation                                        ║
║ → Phase 5: Installation                  [90%]               ║
╠══════════════════════════════════════════════════════════════╣
║ Progress: ██████████████████████████░░░░░  90%              ║
╚══════════════════════════════════════════════════════════════╝

ユーザーに質問: "このスキルをどのようにインストールしたいですか?"

• リポジトリのみ - .github/skills/ 内にファイルが作成されます (リポジトリ内で機能)
• グローバルインストール - ~/.copilot/skills/ でシンボリックリンクを作成 (どこでも機能)
• 両方 - リポジトリ + グローバルシンボリックリンク (推奨、git pull で自動更新)
• インストールをスキップ - ファイルだけを作成

グローバルインストールが選択された場合:

# インストール対象のプラットフォームを検出
INSTALL_TARGETS=()

if [[ "$COPILOT_INSTALLED" == "true" ]] && [[ "$PLATFORM" =~ "copilot" ]]; then
    INSTALL_TARGETS+=("copilot")
fi

if [[ "$CLAUDE_INSTALLED" == "true" ]] && [[ "$PLATFORM" =~ "claude" ]]; then
    INSTALL_TARGETS+=("claude")
fi

if [[ "$CODEX_INSTALLED" == "true" ]] && [[ "$PLATFORM" =~ "codex" ]]; then
    INSTALL_TARGETS+=("codex")
fi

# ユーザーに検出されたプラットフォームの確認を依頼
echo "Detected platforms: ${INSTALL_TARGETS[*]}"
echo "Install for these platforms? [Y/n]"

インストールプロセス:

# GitHub Copilot CLI
if [[ " ${INSTALL_TARGETS[*]} " =~ " copilot " ]]; then
    ln -sf "$SKILLS_REPO/.github/skills/$SKILL_NAME" \
           "$HOME/.copilot/skills/$SKILL_NAME"
    echo "✅ Installed for GitHub Copilot CLI"
fi

# Claude Code
if [[ " ${INSTALL_TARGETS[*]} " =~ " claude " ]]; then
    ln -sf "$SKILLS_REPO/.claude/skills/$SKILL_NAME" \
           "$HOME/.claude/skills/$SKILL_NAME"
    echo "✅ Installed for Claude Code"
fi

# Codex
if [[ " ${INSTALL_TARGETS[*]} " =~ " codex " ]]; then
    ln -sf "$SKILLS_REPO/.codex/skills/$SKILL_NAME" \
           "$HOME/.codex/skills/$SKILL_NAME"
    echo "✅ Installed for Codex"
fi

インストールを検証:

# シンボリックリンクをチェック
ls -la ~/.copilot/skills/$SKILL_NAME 2>/dev/null
ls -la ~/.claude/skills/$SKILL_NAME 2>/dev/null
ls -la ~/.codex/skills/$SKILL_NAME 2>/dev/null

フェーズ 6: 完了

進捗: 完了メッセージを表示:

echo "[████████████████████] 100% - ✓ Skill created successfully!"

進捗を更新:

╔══════════════════════════════════════════════════════════════╗
║ ✓ Phase 5: Installation                                      ║
║ ✅ SKILL CREATION COMPLETE!                                  ║
╠══════════════════════════════════════════════════════════════╣
║ Progress: ██████████████████████████████  100%              ║
╚══════════════════════════════════════════════════════════════╝

概要を表示:

🎉 Skill created successfully!

📦 Skill Name: your-skill-name
📁 Location: .github/skills/your-skill-name/
🔗 Installed: Global (Copilot + Claude)

📋 Files Created:
   ✅ SKILL.md (1,847 words)
   ✅ README.md (423 words)
   ✅ references/ (empty, ready for extended docs)
   ✅ examples/ (empty, ready for code samples)
   ✅ scripts/ (empty, ready for utilities)

🚀 Next Steps:
   1. Test the skill: Try trigger phrases in CLI
   2. Add examples: Create working code samples in examples/
   3. Extend docs: Add detailed guides to references/
   4. Commit changes: git add .github/skills/your-skill-name && git commit
   5. Share: Push to repository for team use

💡 Pro Tips:
   - Keep SKILL.md under 2,000 words (currently: 1,847)
   - Move detailed content to references/ folder
   - Add executable scripts to scripts/ folder
   - Update README.md with real usage examples
   - Run validation before committing: scripts/validate-skill-yaml.sh

エラー処理

プラットフォーム検出の問題

プラットフォームが検出できない場合:

⚠️  Unable to detect GitHub Copilot CLI or Claude Code
    
Would you like to:
1. Install for repository only (works when in repo)
2. Specify platform manually
3. Skip installation

テンプレートが見つからない

テンプレートが見つからない場合:

❌ Error: Template not found at resources/templates/

This skill requires the cli-ai-skills repository structure.

Options:
1. Clone cli-ai-skills: git clone <repo-url>
2. Create minimal skill structure manually
3. Exit and set up templates first

検証失敗

コンテンツが標準を満たさない場合:

⚠️  Validation Issues Found:

1. YAML: Description not in third-person format
   Expected: "This skill should be used when..."
   Found: "Use this skill when..."
   
2. Content: Word count too high (5,342 words, max 5,000)
   Suggestion: Move detailed sections to references/

Fix automatically? [Y/n]

インストール競合

シンボリックリンクが既に存在する場合:

⚠️  Skill already installed at ~/.copilot/skills/your-skill-name

Options:
1. Overwrite existing installation
2. Rename new skill
3. Skip installation
4. Install to different location

バンドルされたリソース

このスキルにはサブディレクトリに追加リソースが含まれています:

references/

必要に応じて読み込まれる詳細資料:

• anthropic-best-practices.md - Anthropic 公式スキル開発ガイドライン
• writing-style-guide.md - ライティング標準と例
• progressive-disclosure.md - コンテンツ構成パターン
• validation-checklist.md - コミット前品質チェック

examples/

スキル使用法を示す動作例:

• basic-skill-creation.md - シンプルなスキル作成のウォークスルー
• advanced-skill-bundled-resources.md - references/ を含む複雑なスキル
• global-installation.md - スキルをシステム全体にインストール

scripts/

スキル保守用の実行可能なユーティリティ:

• validate-all-skills.sh - リポジトリ内のすべてのスキルのバッチ検証
• update-skill-version.sh - バージョン更新とチェンジログを更新
• generate-skill-index.sh - スキルカタログを自動生成

技術実装ノート

テンプレート置換:

• 単純な置換には sed を使用
• YAML フォーマットを完全に保持
• 複数行の説明を適切にエスケープして処理

シンボリックリンク戦略:

• 常に絶対パスを使用: ln -sf /full/path/to/source ~/.copilot/skills/name
• インストール完了前にシンボリックリンクを検証
• メリット: リポジトリを git pull すると自動更新される

検証統合:

• インストール前に検証を実行
• 重大エラーが見つかった場合はインストールをブロック
• 警告は情報提供のみ

Git 統合:

• git config user.name から著者を抽出
• リポジトリルート検出を使用: git rev-parse --show-toplevel
• .gitignore パターンを尊重

品質標準

SKILL.md 要件:

• 1,500-2,000 語 (理想的)
• 5,000 語以下 (最大)
• 三人称説明形式
• 命令形/不定詞ライティングスタイル
• プログレッシブディスクロージャーパターン

README.md 要件:

• 300-500 語
• ユーザーファーシング言語
• 明確なインストール手順
• 実践的な使用例

検証チェック:

• YAML frontmatter の完全性
• 説明フォーマット (三人称)
• 単語数制限
• ライティングスタイル (二人称を使用しない)
• 必須フィールドが存在

参考資料

• Anthropic 公式スキル開発ガイド: https://github.com/anthropics/claude-plugins-official/blob/main/plugins/plugin-dev/skills/skill-development/SKILL.md
• リポジトリ: https://github.com/yourusername/cli-ai-skills
• ライティングスタイルガイド: resources/templates/writing-style-guide.md
• 進捗トラッカーテンプレート: resources/templates/progress-tracker.md

制限事項

• このスキルは、タスクが上記で説明されたスコープに明確に一致する場合のみ使用してください。
• 出力を環境固有の検証、テスト、または専門家レビューの代替として扱わないでください。
• 必要な入力、権限、安全性の境界、または成功基準が不明な場合は、質問することを停止してください。