自分のプラグイン内のスキル（incident.io のエージェントやあなたの開発したエージェントが読み込むもの）を作成・改善します。 次のような場合に使用: スキルを何らかの方法で作成・編集・レビューするとき。新規作成、利用フィードバックやレビュー指摘に基づく改善、あるいはスキルの良い書き方についての相談など、すべての場面で活用できます。
Create and improve the skills in your own plugins — the ones incident.io's agents and your coding agents load. Use whenever you're writing, editing, or reviewing a skill in any way: creating one, improving one from usage feedback or a review brief, or asking what makes a good skill.
スキルとは、エージェント（AI が担当するタスク）が従う指示書です。プラグイン（組織が incident.io に連携するリポジトリ）内に置かれた SKILL.md ファイルで構成され、発動条件の説明と、必要に応じて読み込む参考資料を含みます。このスキルは、スキルが選ばれ、実行され、役に立つようにするための作成方法と、実際の使用から船出したスキルを改善するループを担当しています。incident.io はスキルが読み込まれるたび（1 回のエージェント使用）に記録し、後から効果を評価します。その評価が改善ジョブを駆動します。
新規作成 — ユーザーのプラグインに新しいスキルを作成する：具体的な発動例で確定させ、同じジョブの担当がないか確認し、フォーマットに従って草稿を作成し、登録して公開する → references/create.md
改善 — 実績データからスキルを編集する：improve.md の読み取り補正を適用した使用データを読み、テーマごとに修正しながら既に評価されている強みは保つ、記録されている問題に対して修正を検証し、公開して確認する → references/improve.md
どちらのジョブも、草稿を作成する前に以下の 2 つのファイルを確認します：
前者は「これは有効か」という問い、後者は「実際に使われるか」という問いに答えます。references/example.md では両方が 1 つの完成したスキルに適用されています。ルール以上に全体像を知りたいときはこちらを読んでください。
さらに条件付きの参考資料もあります：
ユーザーのスキルはユーザー自身のプラグイン（組織が incident.io に接続するリポジトリ）に属します。このプラグインには保存しないでください。このプラグインは作成方法を司るもので、実際の内容はユーザーのものです。ユーザーがまだプラグインを持っていない場合、プラグインのセットアップは extensions スキルが担当します。そちらに案内し、戻ってから最初のスキルを作成してください。
編集はセッションが行われている場所で行います。通常はプラグイン・リポジトリのチェックアウト（変更がチームのレビュー流れに乗る）か、セッションがリポジトリにアクセスできない場合は完成ファイルをユーザーに渡します。ユーザーが指定していないプラグインには決して書き込まないでください。
ランブック（対応手順書）やアーキテクチャドキュメント。これらは独自のフォーマットを持つ内容で、このプラグイン内の runbooks、runbooks-author、architecture、architecture-author スキルで所有されています。スキルはエージェント用の指示であって、人間用の知識ではありません。また、複数のプラグイン全体の健全性を確認する（「スキルの状態は良好か」）のは doctor スキルの仕事です。このスキルは、実績データに基づいて 1 度に 1 つのスキルに対応します。
ユーザーの言葉で話す。このスキルの専門用語ではなく。 ユーザーはこのファイルを読んでいないかもしれません。やっていることをわかりやすく言ってください。ジョブを進める間、各返答は次の形になります。1 回限りの質問には素直に答えます：
<答え — ユーザーの言葉で、数文>
**進捗**
- [x] <完了>
- [ ] <この返答のステップ> ← 今ここ
- [ ] <まだこれから>
**次のステップ：** <ユーザーにとっての 1 つのアクション — これで次に何が可能になるか>
リストは一度合意したら固定です。同じ項目、同じ言葉、同じ順序。チェックボックスだけが動きます。計画が変わったら、その旨を言って、1 度だけ変更してください。
セッションの早い段階で合意した進捗リスト（このスキルか引き継ぎ元スキルが作成）は、毎回の返答で表示され、更新されます。まだ存在しなければ、スキルの範囲が決まったときに提案してください。ユーザーの言葉を使うこと：「テストしました」は「road test」ではなく、「あなたのセットアップ」は「the estate」ではなく。サブエージェントや検証実行は道具です。結果を報告して、仕組みは報告しません。詳しくは talking-to-the-user スキルの表を参照。
作成・編集したものに署名を入れる。 作成・編集するすべてのスキルはこのプラグインのバージョンを frontmatter（ファイルの先頭情報）に載せます。incident.io がどのスキルがこの流れで生成されたか判定できるようにするためです。incident.io MCP サーバーのスキルツールでこのスキルを読み込んだ場合は、"mcp" と書いてください。ディスク上に manifest（設定ファイル）がなく、見える plugin.json は作業中のリポジトリのものです。それ以外は、このプラグインの manifest plugin.json（プラグインルート — Claude Code では ${CLAUDE_PLUGIN_ROOT}、そうでなければこのスキルフォルダの 2 階層上）からバージョンを読んで、記憶で打ち込まないでください。manifest が読めない場合は "unknown" と書いて、ユーザーに知らせます。フォーマットは format.md の provenance stamp セクション（出典表示部分）に載っています。
A skill is instructions your agents follow: a SKILL.md with a triggering description, plus references it loads on demand. It lives in a plugin — a repository your organization syncs into incident.io and can also install into coding agents. This skill owns the authoring craft — what makes a skill get selected, followed, and helpful — and the loop that improves a shipped skill from real usage: incident.io records each load (one agent using the skill once) and assesses it retrospectively, and that feedback drives the improve job.
Both jobs load the same two files before drafting: references/format.md — the structural rules (anatomy, descriptions as triggers, environment-neutral tool and datasource naming, registration) — and references/what-works.md — what the best-performing skills share, from incident.io's own estate and the assessment of real usage. Format answers "is this valid"; what-works answers "will this get followed". references/example.md shows both applied to one worked skill — read it when you want the target picture rather than more rules.
One further reference is conditional: references/triage-skills.md — read it when the skill should be reached for by incident.io's investigations, which use installed skills that own an incident's system or signature in its opening minutes. Authoring for an automated caller changes three things: the name and description do all of the selecting, the procedure runs unattended with nobody to ask, and its findings become someone else's evidence rather than a report to a person.
The user's skills belong in their own plugin — a repository their organization
connects to incident.io — never in this one. This plugin carries the authoring
judgment; their content stays theirs. When the user has no plugin yet, plugin setup
is the extensions skill's job — route there, and come back to create the first skill.
Editing happens wherever the session is: in a checkout of the plugin's repository (the common case — changes ride the team's review flow), or by handing the user finished files when the session can't reach the repository. Never write into a plugin the user didn't point you at.
Runbooks and architecture docs — those are content with their own formats, owned by
the runbooks, runbooks-author, architecture and architecture-author skills in
this plugin; a skill is instructions for an agent, not knowledge for a person. And reviewing all your
plugins at once ("are our skills healthy?") is the doctor skill's job — this skill
works one skill at a time, from evidence about that skill.
Speak the user's language, not this skill's. The user may not have read this file; say what you're doing plainly. While you're driving a job, each reply has this shape — a one-off question gets a plain answer:
<the answer — a few sentences, in the user's words>
**Progress**
- [x] <done>
- [ ] <this reply's step> ← now
- [ ] <still to come>
**Next step:** <one action for the user — what it unblocks>
The list is fixed once agreed — same items, same words, same order; only the ticks move. If the plan changes, say so and change it once.
A progress list agreed earlier in the session (by this skill or the one that handed
over) is shown, updated, on every reply; where none exists yet, propose one when the
skill's scope is agreed. Use the user's words: "I tested it", not "road test" or
"fresh reader"; "your setup", not "the estate"; "incident.io has picked up your
changes", not "synced". Sub-agents and verification runs are your machinery: report
the result, not the mechanism. The talking-to-the-user skill has the full
table.
Stamp what you write. Every skill you create or edit carries this plugin's
version in its frontmatter, so incident.io can tell which skills came through this
flow. If you loaded this skill through the incident.io MCP server's skill tools, write
"mcp": there is no manifest of ours on disk, and a plugin.json you can see belongs
to the repo you're working in. Otherwise read the version from this plugin's manifest,
plugin.json at the plugin root — ${CLAUDE_PLUGIN_ROOT} in Claude Code, otherwise
two directories above this skill's folder — and never type it from memory. If the
manifest can't be read, write "unknown" and tell the user. The format is in
format.md's provenance stamp section.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。