Make Skill テンプレート

新しい Agent Skills を作成するためのメタスキルです。新しいスキルフォルダをスキャフォルディングしたい、SKILL.md ファイルを生成したい、または Agent Skills 仕様の理解を支援する必要がある場合にこのスキルを使用します。

このスキルを使うタイミング

• ユーザーが「スキルを作成する」「新しいスキルを作る」「スキルをスキャフォルディングする」と言う場合
• ユーザーが GitHub Copilot 設定に専門的な機能を追加したい場合
• ユーザーがバンドルされたリソースを含むスキルを構造化する支援が必要な場合
• ユーザーがこのテンプレートを出発点として複製したい場合

前提条件

• スキルが何を実現するべきかの理解
• 機能とトリガーの明確でキーワード豊かな説明
• 必要なバンドルリソースの知識（スクリプト、参考資料、アセット、テンプレート）

新しいスキルの作成

ステップ1: スキルディレクトリを作成する

小文字でハイフンで区切られた名前のフォルダを作成します：

skills/<skill-name>/
└── SKILL.md          # Required

ステップ2: Frontmatter でSKILL.md を生成する

すべてのスキルには name と description を含む YAML frontmatter が必要です：

---
name: <skill-name>
description: '<何をするか>. <特定のトリガー、シナリオ、ユーザーが言及するかもしれないキーワード>の場合に使用します。'
---

Frontmatter フィールドの要件

フィールド	必須	制約
name	はい	1～64文字、小文字/数字/ハイフンのみ、フォルダ名と一致する必要がある
description	はい	1～1024文字、何をするか、いつ使うかを説明する必要がある
license	いいえ	ライセンス名またはバンドルされた LICENSE.txt への参照
compatibility	いいえ	1～500文字、必要に応じて環境要件
metadata	いいえ	追加プロパティのキーバリューペア
allowed-tools	いいえ	事前承認されたツールのスペース区切りリスト（実験的）

Description のベストプラクティス

重要: description は自動スキル発見の主要なメカニズムです。以下を含める必要があります：

1. 何を スキルが実行するか（機能）
2. いつ 使用するか（トリガー、シナリオ、ファイルタイプ）
3. キーワード ユーザーがプロンプトで言及するかもしれない

良い例：

description: 'Playwright を使用したローカルウェブアプリケーションテストツールキット。フロントエンド機能を検証したい、UI の動作をデバッグしたい、ブラウザスクリーンショットをキャプチャしたい、またはブラウザコンソールログを表示したい場合に使用します。Chrome、Firefox、WebKit に対応しています。'

悪い例：

description: 'ウェブテストヘルパー'

ステップ3: スキルの本文を書く

frontmatter の後、markdown 命令を追加します。推奨セクション：

セクション	目的
# タイトル	簡潔な概要
## このスキルを使うタイミング	description のトリガーを強化
## 前提条件	必要なツール、依存関係
## ステップバイステップワークフロー	タスクの番号付きステップ
## トラブルシューティング	一般的な問題と解決策
## 参考資料	バンドルされたドキュメントへのリンク

ステップ4: オプションのディレクトリを追加（必要に応じて）

フォルダ	目的	使用するタイミング
scripts/	実行可能なコード（Python、Bash、JS）	操作を実行する自動化
references/	エージェントが読むドキュメント	API リファレンス、スキーマ、ガイド
assets/	そのまま使用される静的ファイル	画像、フォント、テンプレート
templates/	エージェントが変更するスターターコード	拡張するスキャフォルド

例：完全なスキル構造

my-awesome-skill/
├── SKILL.md                    # Required instructions
├── LICENSE.txt                 # Optional license file
├── scripts/
│   └── helper.py               # Executable automation
├── references/
│   ├── api-reference.md        # Detailed docs
│   └── examples.md             # Usage examples
├── assets/
│   └── diagram.png             # Static resources
└── templates/
    └── starter.ts              # Code scaffold

クイックスタート：このテンプレートを複製する

1. make-skill-template/ フォルダをコピーする
2. スキル名に変更（小文字、ハイフン）
3. SKILL.md を更新：
   • name: をフォルダ名に変更
   • キーワード豊かな description: を書く
   • 本文の内容をあなたの指示に置き換える
4. 必要に応じてバンドルされたリソースを追加
5. npm run skill:validate で検証

検証チェックリスト

• フォルダ名は小文字とハイフン
• name フィールドはフォルダ名と完全に一致
• description は 10～1024文字
• description は何と何をするかを説明
• description はシングルクォートで囲まれている
• 本文の内容は 500行以下
• バンドルされたアセットは各 5MB 以下

トラブルシューティング

問題	解決策
スキルが発見されない	より多くのキーワードとトリガーで description を改善
名前での検証失敗	小文字を確認、連続したハイフンなし、フォルダと一致
Description が短すぎる	機能、トリガー、キーワードを追加
アセットが見つからない	スキルルートからの相対パスを使用

参考資料

• Agent Skills 公式仕様: https://agentskills.io/specification