メニュー
スキル定義ファイル（SKILL.md）の作成・更新を支援する。frontmatter 設計、description のトリガーキーワード調整、本文構成、progressive disclosure 設計、発火テストを含む。スキル作成、SKILL.md、frontmatter、description、.agents/skills、発火しない、トリガーワード、name フィールド、スキル競合などの言及時に使用。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | skill-writing |
| description | スキル定義ファイル（SKILL.md）の作成・更新を支援する。frontmatter 設計、description のトリガーキーワード調整、本文構成、progressive disclosure 設計、発火テストを含む。スキル作成、SKILL.md、frontmatter、description、.agents/skills、発火しない、トリガーワード、name フィールド、スキル競合などの言及時に使用。 |
| user-invokable | false |
.agents/prompts/99_create-skill.prompt.md.agents/skills/99_skill-writing/scripts/init_skill.sh <name>.agents/skills/99_copilot-instructions-maintenance/SKILL.md.agents/skills/agent-script-writing/SKILL.mdname: MySkill, name: スキル名name: my-skill（要件は Frontmatter > MUST 参照）description: ドキュメントを扱うdescription: Excelスプレッドシートを分析し、ピボットテーブルを作成する。Excelファイル、.xlsxファイルを分析する際に使用。AI エージェントは既に賢い。手順・制約・例（必要最小限）に絞る。
発火の決定打。name と description の2フィールドのみ。
---
name: your-skill-name
description: [何をする]。[いつ使う]に使用。[トリガーワード]などの言及時に使用。
---
name: 小文字・数字・ハイフンのみ、64文字以内、XMLタグ/予約語（anthropic, claude）禁止description: 空禁止、1024文字以内、XMLタグ禁止、三人称で書くdescription の構造: What（何をするか）+ When（いつ使うか）+ Keywords（トリガーワード）
Keywords の書き方:
.xlsx, gh pr diff, SKILL.md）PR, pull request, プルリクエスト）避けること:
タスクの脆弱性に合わせて指示の具体度を調整する。
複数手段がある場合はデフォルトを1つ提示し、必要なときだけ例外を示す。
.agents/skills/{name}/
├── SKILL.md # 必須: メイン指示（発火時に読み込まれる）
├── scripts/ # 任意: 実行可能コード
├── references/ # 任意: 必要時に読む詳細ドキュメント
└── assets/ # 任意: 出力用素材（コンテキストに読み込まない）
99_）.agents/docs/prefix-naming-convention.md1スキル = 1能力。トリガーワード・入出力・失敗パターンのいずれかが別物なら分割する。
記述トーン: 命令形/不定詞で統一する（「〜する」「〜を確認」）。説明文体（「〜します」「〜できます」）は使わない。
スキルの性質に合わせて構成を選ぶ:
パターンは混合可能。init_skill.sh が生成するデフォルト（下記）は Workflow-Based 寄り:
500行以内に収める。超えそうなら progressive disclosure で分離。
本文で使えるパターン。詳細は公式 BP: Common patterns 参照。
SKILL.md が肥大化する場合、詳細を references/ に分離。
## 応用
- **詳細仕様**: [references/details.md](references/details.md)
- **API参照**: [references/api.md](references/api.md)
/ を使う（Windows形式 \ は避ける）ServerName:tool_name）runSubagent でテスト可能。テスト時は「スキル定義を読み込ませず」純粋なユーザーとして振る舞わせる。
反復改善は公式 BP: Develop Skills iteratively 参照。
スキル作成・更新後の最終確認:
name が公式要件（文字種、長さ、予約語、XMLタグ禁止）を満たすdescription が What/When/Keywords を満たし、限定語で競合回避できている.agents/scripts/ や skills/*/scripts/ 配下のシェルスクリプトを作成・整備する。エージェントが実行する前提の統一ルール（shebang、エラーハンドリング、日本語コメント、ステップ分割）に従う。「.agents/scripts」「skills/*/scripts」「#!/bin/bash」「スクリプト作成」「スクリプトを整える」などの言及時に使用。
.agent.mdファイルを作成・編集する。frontmatter（tools, handoffs, model）の設計、エージェントの責務定義を支援。agent.md作成、.agent.md編集、.github/agents、カスタムエージェント、handoffs、tools、エージェント定義などの言及時に使用。
Copilot向け instructions/prompts/skills/agents の整備。`.github/agents`/`.agents` 配下の `*.instructions.md`/`*.prompt.md`/`*.agent.md`/`SKILL.md` を編集、追跡対象（`.github/copilot-instructions.md`等）は提案のみ。instructions整備、applyTo、excludeAgent、.git/info/exclude、ルール変更などで使用。
Agent Hook（.json）の作成・編集を行う。hookイベント、matcher、入出力フォーマット、exit code、設置場所の設計を支援する。hook作成、hooks、PreToolUse、PostToolUse、SessionStart、Stop、.github/hooks、/hooks、agent hook、hookファイルなどの言及時に使用。
.instructions.mdファイルを作成・編集する。frontmatter（applyTo）の設計、repo-wide vs path-specific の使い分け、glob パターンの書き方を支援。instructions.md作成、.instructions.md編集、.agent/instructions、.github/instructions、applyTo、globパターン、path-specific、repo-wideなどの言及時に使用。
VS Code用のprompt.mdファイルを作成・編集する。frontmatter（name/description/argument-hint必須）、本文の手順記述、skillとの役割分担を支援。prompt.md作成、.prompt.md編集、.agent/prompts、.github/prompts、プロンプトファイル、テンプレート利用などの言及時に使用。