Skills Generator

Skills Generator — Agent Skills のメタスキル

スキル読み込み通知

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

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

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

| モード | 説明 | トリガー例 | |--------|------|-----------| | 🔨 Generate | 新しいスキルを一式作成（スクリプト付きも対応） | 「pytestのスキルを作って」「自動化スクリプト付きで」 | | ✨ Improve | 既存スキルをベストプラクティスに基づき改善 | 「スキルを改善して」「発火条件を良くして」 | | 🛡️ Audit | 既存スキルのセキュリティ診断 | 「スキルをチェックして」「スキルを監査」 | | 🌐 Localize | 英語スキルの日本語化 | 「スキルを日本語化して」「翻訳して」 |

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

---

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/               # オプション：テンプレート・図

各フォルダの使い分け：

| フォルダ | 用途 | 追加する条件 | |---------|------|-------------| | scripts/ | 自動化スクリプト、診断ツール | スキルがコマンド実行を伴う場合 | | references/ | 仕様書、ガイドライン、チェックリスト、実装パターン | 詳細な参照情報がある場合 | | examples/ | サンプルコード、実装例 | 具体的なコード例が必要な場合 | | assets/ | テンプレート、ひな型 | 出力フォーマットが決まっている場合 |

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

Step 3: SKILL.md の作成

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

📄 [assets/skill-template.md](assets/skill-template.md)

作成時のルール：

1. name: 小文字の英字・数字・ハイフンのみ（最大64文字）
2. description: 1行で完結させる。改行や | は使わない。以下を必ず含める：

• スキルの目的（何をするか）
• 発火キーワード（日本語・英語の両方が望ましい）

1. スキル読み込み通知: 必須。スキルが読み込まれたら、ユーザーにスキル名と目的を通知する指示を含める（テンプレートに含まれています）
2. 本文: 手順（Step）を軸に構成し、詳細は外部ファイルへ分離する

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

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

分離の判断基準：

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

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

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

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

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

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

| ユーザーの要望 | スクリプトの種類 | 例 | |---------------|----------------|-----| | 「ファイルを自動生成したい」 | ジェネレーター | テンプレートからファイルを生成するスクリプト | | 「チェックを自動化したい」 | バリデーター | lint、型チェック、規約チェック | | 「データを変換したい」 | トランスフォーマー | フォーマット変換、マイグレーション | | 「情報を収集したい」 | コレクター | プロジェクト情報の収集・集約 | | 「定型処理をまとめたい」 | ワークフロー | 複数コマンドの一括実行 |

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

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

📄 [references/script-patterns.md](references/script-patterns.md)

主要な原則：

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

## 使い方

スクリプトを実行して○○を行います：

\```bash
node scripts/generate.mjs --target src/
\```

Step 6: 品質チェック

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

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

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

詳細は以下を参照：

📄 [references/best-practices.md](references/best-practices.md)

---

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

概要

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

手順

Step 1: 対象スキルの分析

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

| 評価軸 | チェック内容 | |--------|-------------| | 発火精度 | description の記述が十分か、発火キーワードが適切か | | 構造品質 | SKILL.md がスリムか、外部ファイル分離が適切か | | 網羅性 | 必要な手順・リファレンス・テンプレートが揃っているか | | 実用性 | 実際の業務フローに沿った指示になっているか | | スクリプト | 自動化すべき処理がスクリプト化されているか | | 実装パターン | プロジェクト固有の注意点・ワークアラウンドがリファレンスとして整備されているか |

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

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

📄 [assets/improvement-report-template.md](assets/improvement-report-template.md)

Step 3: 改善の実施

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

発火条件の改善:

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

📄 [references/improve-checklist.md](references/improve-checklist.md)

主な改善パターン：

| 問題 | 原因 | 改善方法 | |------|------|---------| | スキルが発火しない | description のキーワード不足 | ユーザーが使いそうなフレーズを追加 | | 関係ないときに発火する | description が曖昧 | 具体的な条件と除外条件を明記 | | 出力が期待と違う | 指示が不明確 | Step の手順を具体化、テンプレートを追加 | | 毎回似たことを聞かれる | コンテキスト不足 | references/ にプロジェクト固有情報を追加 | | 手動作業が多い | 自動化が不足 | scripts/ にヘルパースクリプトを追加 | | 実装時に同じミスを繰り返す | プロジェクト固有の注意点が未整備 | references/ に実装パターン・注意点リファレンスを追加 |

構造の改善:

• 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](references/security-checklist.md)

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

| カテゴリ | チェック項目 | リスクレベル | |---------|-------------|-------------| | データ流出 | 外部URLへのデータ送信指示 | 🔴 Critical | | コード実行 | 任意のシェルコマンド実行指示 | 🔴 Critical | | ファイル操作 | 意図しないファイル削除・上書き | 🟠 High | | 権限昇格 | sudo / 管理者権限の要求 | 🟠 High | | 情報収集 | 環境変数・認証情報の読み取り | 🟠 High | | 隠蔽 | 指示の存在を隠す記述 | 🔴 Critical |

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

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

📄 [assets/audit-report-template.md](assets/audit-report-template.md)

---

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

概要

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

手順

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

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

Step 2: 翻訳の実行

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

| 要素 | 翻訳方針 | |------|---------| | name フィールド | 翻訳しない（英字・ハイフンのみの制約） | | description フィールド | 日本語に翻訳し、日本語の発火キーワードを追加 | | 見出し・本文 | 日本語に翻訳 | | コード・コマンド | 翻訳しない（コメントのみ翻訳可） | | ファイル名・パス | 翻訳しない | | 技術用語 | 初出時に 原語（日本語） の形式で併記し、以降は日本語のみ |

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

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

Step 4: 出力

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

---

参照ドキュメント

| ドキュメント | 内容 | |-------------|------| | [assets/skill-template.md](assets/skill-template.md) | SKILL.md の作成テンプレート | | [assets/audit-report-template.md](assets/audit-report-template.md) | セキュリティ診断レポートテンプレート | | [assets/improvement-report-template.md](assets/improvement-report-template.md) | スキル改善レポートテンプレート | | [references/best-practices.md](references/best-practices.md) | スキル設計のベストプラクティス | | [references/improve-checklist.md](references/improve-checklist.md) | 既存スキル改善チェックリスト | | [references/script-patterns.md](references/script-patterns.md) | ヘルパースクリプト作成パターン集 | | [references/security-checklist.md](references/security-checklist.md) | セキュリティ診断チェックリスト | | [references/skill-standard-summary.md](references/skill-standard-summary.md) | Agent Skills Standard 仕様サマリー | | [references/implementation-patterns-guide.md](references/implementation-patterns-guide.md) | 実装パターン・注意点リファレンス作成ガイド | | [examples/example-skill/](examples/example-skill/) | 良いスキルの実装例 |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: safubuki
• Source: safubuki/skills-generator
• License: MIT

Install and usage instructions live in the source repository linked above.