メニュー
.agents/scripts/ や skills/*/scripts/ 配下のシェルスクリプトを作成・整備する。エージェントが実行する前提の統一ルール（shebang、エラーハンドリング、日本語コメント、ステップ分割）に従う。「.agents/scripts」「skills/*/scripts」「#!/bin/bash」「スクリプト作成」「スクリプトを整える」などの言及時に使用。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
.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、プロンプトファイル、テンプレート利用などの言及時に使用。
スキル定義ファイル（SKILL.md）の作成・更新を支援する。frontmatter 設計、description のトリガーキーワード調整、本文構成、progressive disclosure 設計、発火テストを含む。スキル作成、SKILL.md、frontmatter、description、.agents/skills、発火しない、トリガーワード、name フィールド、スキル競合などの言及時に使用。
| name | agent-script-writing |
| description | .agents/scripts/ や skills/*/scripts/ 配下のシェルスクリプトを作成・整備する。エージェントが実行する前提の統一ルール（shebang、エラーハンドリング、日本語コメント、ステップ分割）に従う。「.agents/scripts」「skills/*/scripts」「#!/bin/bash」「スクリプト作成」「スクリプトを整える」などの言及時に使用。 |
| user-invokable | false |
.agents/scripts/ や skills/*/scripts/ 配下に配置するスクリプトの作成・整備ルール。
エージェント実行前提で統一された品質を保つ。
❌ shebang なし・実行権限なし → エージェントが bash xxx.sh と書く必要がある
✅ #!/bin/bash + 実行権限 → ./xxx.sh で直接実行可能
❌ コメントが英語・欠落 → 修正時に意図を損なう
✅ 日本語コメント → 目的とステップを明示
❌ エラーハンドリングなし → 途中で失敗しても続行してしまう
✅ set -euo pipefail → エラー時に即座に終了
配置原則: skills/{skill}/scripts/ に配置。汎用的なもののみ .agents/scripts/
#!/bin/bash を1行目にset -euo pipefail詳細なテンプレートは references/templates.md 参照。
# 1. init_script.sh で雛形生成（実行権限も自動付与)
.agents/skills/agent-script-writing/scripts/init_script.sh .agents/scripts/new_script.sh
# 2. エディタで内容を実装
# - 目的コメント記述
# - 引数チェック調整
# - 各ステップ実装
# 3. 動作確認
.agents/scripts/new_script.sh test_arg
完成時は references/checklist.md で確認。
コード例は references/examples.md 参照。
エージェント実行前提で、統一ルールに従い保守しやすいスクリプトを作成する。