メニュー
VS Code用のprompt.mdファイルを作成・編集する。frontmatter（name/description/argument-hint必須）、本文の手順記述、skillとの役割分担を支援。prompt.md作成、.prompt.md編集、.agent/prompts、.github/prompts、プロンプトファイル、テンプレート利用などの言及時に使用。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | prompt-writing |
| description | VS Code用のprompt.mdファイルを作成・編集する。frontmatter（name/description/argument-hint必須）、本文の手順記述、skillとの役割分担を支援。prompt.md作成、.prompt.md編集、.agent/prompts、.github/prompts、プロンプトファイル、テンプレート利用などの言及時に使用。 |
| user-invokable | false |
VS Code用のprompt.mdファイルを作成・編集するためのガイド。手順を記述し、skillとの役割分担を実現。
Prompts は明示呼び出し。instructions より重くても許容されるが、それでも簡潔に。
作成・編集後は必ず圧縮レビュー実施（Reviewer モード・圧縮レビュー実施中は除く）:
ファイルパスのリンク化: 手順実行に必須の参照は [path](path)、補足は path のみ。詳細は copilot-instructions-maintenance
以下のようなミスを防ぐために、このスキルを使用する。
❌ frontmatterの必須項目が不足している
name、descriptionが未記入argument-hintが未記入❌ 本文にルールや知識を書きすぎている
❌ 手順が曖昧で実行できない
✅ 正しいやり方
assets/template.prompt.md）とスクリプト（scripts/init_prompt.sh）を活用---
name: prompt-name # 必須: チャットで使う名前（小文字・数字・ハイフンのみ）
description: 短い説明 # 必須: プロンプトの目的を1文で
argument-hint: 引数の説明 # 引数がある場合は必須
agent: agent-name # 任意: ユーザーから指定があれば記述
model: model-name # 任意: ユーザーから指定があれば記述
# tools: [...] # 原則記述しない（セッション継続で面倒なため）
---
このスキルには以下のリソースが含まれています:
assets/template.prompt.md - 詳細版の基本構造scripts/init_prompt.sh - テンプレートから新規prompt.mdを生成（1行説明程度）使い方: .agents/skills/99_prompt-writing/scripts/init_prompt.sh {prompt-name}
.agents/skills/99_prompt-writing/scripts/init_prompt.sh {prompt-name}
.agent/prompts/{prompt-name}.prompt.md が作成されるテンプレートの構造に従って、以下を記述:
各ステップ内に対話を含めることで、インタラクティブな実行を実現:
### ステップ1: 情報収集
1. **ユーザーから以下の情報を確認**
- プロンプトの目的
- 対象とするタスクの種類
- 必要な引数の有無
2. **収集した情報を整理して提示**
- 確認のため整理した内容をユーザーに提示
- 修正が必要か確認
ファイル名にはプレフィックス（10_, 20_, 30_, 99_）を付けて分類します。
詳細: プレフィックス命名規則
../../.agents/skills/{skill-name}/SKILL.md.agent/prompts/ または .github/prompts/詳細は以下を参照:
prompt.mdは「手順」に集中し、ルールはskillに分離する。各ステップに対話を組み込み、具体的で実行可能な指示を記述する。
.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などの言及時に使用。
スキル定義ファイル（SKILL.md）の作成・更新を支援する。frontmatter 設計、description のトリガーキーワード調整、本文構成、progressive disclosure 設計、発火テストを含む。スキル作成、SKILL.md、frontmatter、description、.agents/skills、発火しない、トリガーワード、name フィールド、スキル競合などの言及時に使用。