Skills Generator — Agent Skills のメタスキル

スキル読み込み通知

このスキルが読み込まれたら、必ず以下の通知をユーザーに表示してください：

💡 Skills Generator スキルを読み込みました
Agent Skillsの作成・改善・診断・ローカライズを行います。

Agent Skills を 作成・改善・診断・ローカライズ するためのメタスキルです。 ユーザーの要望に応じて、以下の4つのモードで動作します。

また、ユーザーが「こんなことしたい」「〜を自動化したい」と漠然とした要望を伝えた場合でも、目的を分析して最適なスキル構成を提案・生成します。

When to Use

• 新しい Agent Skill を作成したいとき
• 「こんなことできたらいいな」を実現するスキルが欲しいとき
• ヘルパースクリプト付きの自動化スキルを作りたいとき
• 既存スキルの発火条件・構造・品質を改善したいとき
• スキルが思ったように発火しない・期待と違う動作をするとき
• 外部から取得したスキルの安全性を確認したいとき
• 英語で書かれたスキルを日本語に翻訳したいとき

Mode 1: Generate — スキル新規作成

手順

Step 1: ヒアリング

ユーザーから以下の情報を確認する：

1. 目的: 何をするスキルか（例: pytest実行、セキュリティ分析、コードレビュー）
2. スコープ: プロジェクト固有か、汎用か
3. 配置先: .github/skills/（プロジェクト）か ~/.copilot/skills/（個人）か
4. 必要リソース: テンプレート、スクリプト、参照ドキュメントが必要か
5. 自動化: ヘルパースクリプトで自動化したい処理があるか

💡 ユーザーが「こんなことしたい」「あんな事ができたら」と漠然とした要望の場合は、目的から逆算して最適な構成を提案する。必要に応じて Generate + scripts/ の組み合わせを自動的に選択する。

Step 2: スキル構成の設計

以下のディレクトリ構成を基本として、必要に応じて各オプションフォルダを追加する：

.github/skills/{skill-name}/
├── SKILL.md              # 必須：スキル定義
├── scripts/              # オプション：ヘルパースクリプト
├── references/           # オプション：参照ドキュメント・仕様
├── examples/             # オプション：実装例・サンプル
└── assets/               # オプション：テンプレート・図

各フォルダの使い分け：

💡 実装パターン・注意点の組み込み: プロジェクトオーバービュースキルを作成する場合、references/ に 実装パターン・注意点リファレンス を含めることを強く推奨する。調査方法・出力フォーマット・完全な例は以下を参照：

📄 references/implementation-patterns-guide.md

Step 3: SKILL.md の作成

SKILL.md テンプレートは以下を参照：

📄 assets/skill-template.md

作成時のルール：

1. name: 小文字の英字・数字・ハイフンのみ（最大64文字）
2. description: 1行で完結させる。改行や | は使わない。以下を必ず含める：
   • スキルの目的（何をするか）
   • 発火キーワード（日本語・英語の両方が望ましい）
3. スキル読み込み通知: 必須。スキルが読み込まれたら、ユーザーにスキル名と目的を通知する指示を含める（テンプレートに含まれています）
4. 本文: 手順（Step）を軸に構成し、詳細は外部ファイルへ分離する

Step 4: オプションファイルの作成

SKILL.md 本文にテンプレートやチェックリストを直接埋め込まず、外部ファイルに分離する。

分離の判断基準：

• 10行を超えるコードブロック → assets/ または examples/ へ
• 表形式のリファレンス → references/ へ
• 実行可能なスクリプト → scripts/ へ

SKILL.md からは相対パスのリンクで参照する：

markdown
1📄 **[assets/template.md](assets/template.md)**
2📄 **[references/guidelines.md](references/guidelines.md)**

Step 5: ヘルパースクリプトの作成（該当する場合）

スキルが コマンド実行を伴う自動化 を含む場合、scripts/ フォルダにヘルパースクリプトを作成する。

スクリプトが必要なケースの判断：

スクリプト作成のルール：

スクリプト作成のパターン集と安全性ガイドラインは以下を参照：

📄 references/script-patterns.md

主要な原則：

1. 言語選択: プロジェクトの技術スタックに合わせる。迷ったら Node.js（.mjs）か Python（.py）か Shell（.sh/.ps1）
2. 安全性: 破壊的操作は必ず --dry-run オプションを提供し、デフォルトではドライランとする
3. 冪等性: 何度実行しても同じ結果になるようにする
4. エラーハンドリング: 失敗時に明確なエラーメッセージを出力する
5. SKILL.md からの参照: スクリプトの使い方を SKILL.md に記述する

markdown
1## 使い方
2
3スクリプトを実行して○○を行います：
4
5\```bash
6node scripts/generate.mjs --target src/
7\```

Step 6: 品質チェック

作成したスキルについて以下を確認する：

• name が命名規則に準拠しているか
• description が1行で、発火キーワードを含んでいるか
• スキル読み込み通知セクションが含まれているか
• SKILL.md が肥大化していないか（外部ファイル分離が適切か）
• 外部ファイルへのリンクが正しいか
• scripts/ がある場合、スクリプトが安全で冪等か
• 日本語で記述されているか

スキル設計のベストプラクティス

詳細は以下を参照：

📄 references/best-practices.md

Mode 2: Improve — 既存スキルの改善

概要

プロジェクトに既に存在するスキルを分析し、ベストプラクティスに基づいて改善します。 発火条件の最適化、構造の改善、不足している機能の追加などを行い、スキルの効果を最大化します。

手順

Step 1: 対象スキルの分析

対象スキルの全ファイルを読み込み、以下の観点で現状を評価する：

Step 2: 改善レポートの作成

改善提案を以下のフォーマットで出力する：

📄 assets/improvement-report-template.md

Step 3: 改善の実施

ユーザーの承認を得た上で、以下の改善を実施する：

発火条件の改善:

発火しない・意図と違う発火をする場合の改善チェックリストは以下を参照：

📄 references/improve-checklist.md

主な改善パターン：

構造の改善:

• SKILL.md が100行を超えている → テンプレート・リファレンスを外部ファイルに分離
• assets/ / references/ が未使用 → 必要に応じてフォルダとファイルを追加
• scripts/ が必要そうな処理がある → ヘルパースクリプトを作成

Step 4: 改善結果の検証

• 改善後の description で意図通りに発火するか
• 既存の機能が損なわれていないか
• 外部ファイルへのリンクが正しいか
• スクリプトが追加された場合、安全に動作するか

Mode 3: Audit — セキュリティ診断

概要

Agent Skills は SKILL.md に任意の指示を記述できるため、悪意のある指示が埋め込まれるリスクがあります。 このモードでは、指定されたスキル（または全スキル）をチェックし、セキュリティリスクを報告します。

手順

Step 1: 対象の特定

• 特定のスキル名が指定された場合 → そのスキルのみ診断
• 「全部チェック」の場合 → .github/skills/ 配下の全スキルを診断
• 外部から取得したスキルの場合 → 優先的に詳細チェック

Step 2: セキュリティチェックの実行

以下のチェックリストに基づいて診断する：

📄 references/security-checklist.md

主要なチェック項目（抜粋）：

Step 3: 診断レポートの出力

レポートテンプレートは以下を参照：

📄 assets/audit-report-template.md

Mode 4: Localize — 日本語ローカライズ

概要

GitHub や Anthropic のリポジトリなどから取得した英語スキルを、機能を変えずに日本語化します。

手順

Step 1: 対象スキルの読み込み

対象スキルの全ファイル（SKILL.md + オプションフォルダ）を読み込む。

Step 2: 翻訳の実行

以下のルールに従って翻訳する：

Step 3: セキュリティチェック

外部から取得したスキルは、ローカライズの前後に Mode 3: Audit を自動実行する。

Step 4: 出力

翻訳後のスキルを同じディレクトリ構成で出力する。元のスキルは上書きする（不安であれば事前にバックアップを提案）。

参照ドキュメント