메뉴
公式のベストプラクティスに従って Claude エージェントスキル（SKILL.md、リファレンスファイル、ユーティリティスクリプト）を設計し、実装する。スキルの作成、執筆、構築、更新、改善を求められた場合、SKILL.md に言及された場合、または Claude エージェントの能力を設計する場合に使用する。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | write-skill |
| description | 公式のベストプラクティスに従って Claude エージェントスキル（SKILL.md、リファレンスファイル、ユーティリティスクリプト）を設計し、実装する。スキルの作成、執筆、構築、更新、改善を求められた場合、SKILL.md に言及された場合、または Claude エージェントの能力を設計する場合に使用する。 |
| allowed-tools | ["Bash","Glob","Grep","Read","Edit","Write"] |
ユーザーに確認する:
ファイルを書く前に、既存のレイアウトを把握する:
ls <skills-root>/
代表的な SKILL.md を 1 つ読み、命名規則、フロントマターフィールド、スタイルを確認する。それらの規則を正確に踏襲する。
skill-name/
├── SKILL.md # 必須。500 行以内に収める。
├── references/ # ドメイン固有・めったに参照しない内容はここに
│ └── topic.md
└── scripts/ # 確定的で再利用可能な操作はここに
└── helper.py
SKILL.md テンプレート:
---
name: skill-name
description: 何をするスキルか。Use when [特定のキーワード / コンテキスト / ファイルタイプ]。
---
# スキル名
## クイックスタート
[最小限の動作例]
## ワークフロー
[複雑なタスクのステップバイステップチェックリスト]
## 高度な機能
詳細は [topic.md](references/topic.md) を参照
ユーザーへ提示する前に、レビューチェックリストでセルフチェックする。
ユーザーが満足するまで繰り返す。
| 制約 | ルール |
|---|---|
| フォーマット | 小文字、数字、ハイフンのみ |
| 最大文字数 | 64 文字 |
| 推奨スタイル | 動名詞形: processing-pdfs, writing-skills |
| 禁止 | 予約語: anthropic-*, claude-*; XML タグ |
Use when [特定のトリガー]良い例: "Excel スプレッドシートを分析してピボットテーブルを作成する。.xlsx ファイル、表形式データ、スプレッドシートを分析する場合に使用する。"
悪い例: "ドキュメントを支援する。"（スキル選択のコンテキストが何もない）
タスクの脆弱性に応じて指示の具体性を調整する:
references/ に分離されているパターン、アンチパターン、評価の詳細なガイダンスについては: references/BEST-PRACTICES.md を参照
git コマンドで変更ファイルを解析し、論理的な単位で適切な粒度のコミットを作成する。 ステージ済みまたは未ステージの git 変更が存在し、グループ化してコミットする必要がある場合に使用する。
セッションのコンテキストが肥大化したときに、現在のタスク状況・変更ファイル・作業サマリを収集し、 新しいセッションへ引き継ぐためのドキュメントを生成する。 会話が長くなって新しいセッションで作業を続けたい場合に使用する。
AI 特有の文章パターンを排除し、自然で簡潔な日本語テキストを生成・レビューする。 報告書・文書・その他の出力として自然で人間らしい日本語が求められる場合に使用する。 Japanese triggers: レポート、報告書、文書、まとめ、サマリー、日本語で書く、日本語で出力、自然な日本語
ベースブランチにマージ済みのローカル作業ブランチを安全に削除する。 リモートブランチの削除は明示的に指示された場合のみ実行する。 マージ済みブランチの整理、PR マージ後の古いブランチ削除、ローカルやリモートの refs の整頓時に使用する。
定量的かつ定性的な調査を通じて事実と意見を収集し、分析して 構造化されたレポートや提言として実行可能な知見を提供する。 市場動向、テクノロジー、競合分析など、複数の角度から調査が必要なテーマに使用する。
対話を通じてインタラクティブに Mermaid ダイアグラムを作成するスキル。 ユーザーが可視化したい内容を明確にし、ASCII アートでスケルトンを確認してから 合意が得られた時点で正確な Mermaid コードを生成する。 ダイアグラム、フローチャート、シーケンス図、ER 図、クラス図、状態図、 ガントチャート、マインドマップ、その他の可視化を求められた場合に使用する。 トリガー: 「図を描いて」「可視化して」「フローチャートを作って」「シーケンス図」 「ER 図」「クラス図」「状態機械」「ガントチャート」「Mermaid ダイアグラム」 「システムフローを図にして」「プロセスを図解して」「ダイアグラムにして」