自分のプラグイン内のスキル（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.
スキルとは、エージェント（自動処理を実行するプログラム）が従う指示のことです。プラグイン（組織が incident.io に連携させ、コーディングエージェントにもインストールできるリポジトリ）の中に、動作を開始するための説明文と必要に応じて読み込まれる参考資料が含まれた SKILL.md というファイルとして存在します。
このスキルは、どのようにしてスキルが選ばれ、実行され、役に立つようになるかという「スキル作成の工夫」を担当しており、さらに運用開始後のスキルを実際の使用状況から改善するループも管理しています。incident.io は利用のたびに記録を残し（1回のエージェント実行 = 1回の利用記録）、後からそれを評価し、そのフィードバックが改善作業を推進します。
新規作成 — ユーザーのプラグインに新しいスキルを作成する。具体的な動作例を決定し、同じ機能を持つスキルが既にないか確認し、所定の形式で下書きし、登録して公開する。
改善 — 実際の使用データから既存スキルを修正する。利用フィードバック（改善判定が適用済み）を読み込み、強みを壊さないようテーマごとに修正し、記録されている実例で修正内容を確認してから公開する。
両方の作業を始める前に、同じ2つのファイルを確認します。
形式ルールは「有効かどうか」を判断し、成功パターンは「実際に使われるかどうか」を判断します。実際に完成させたスキルの例も参照でき、ルールだけでなく全体像を見たいときに役立ちます。
さらに、条件によっては別の参考資料も必要です。作成するスキルが incident.io の自動調査で使われる場合（インストール済みスキルで、インシデント（問題発生の報告）のシステムやタイプに対応するもの）、調査機能専用の注意点を確認してください。自動実行向けスキルを作る場合は、名前と説明文がすべての判断を担い、誰も対応できない無人実行となり、その結果は人への報告ではなく別の誰かの判断材料になります。
ユーザーのスキルは、ユーザー自身のプラグイン（組織が incident.io に接続したリポジトリ）に置きます。このプラグインには置きません。このプラグインはスキル作成の判断例を示すもので、ユーザーのコンテンツはユーザーのものです。ユーザーがまだプラグインを持っていない場合は、別のスキル（プラグイン設定専用）がセットアップを担当するので、そちらに案内してから戻ってきてください。
編集は作業中のセッションの場所で行います。プラグインのリポジトリをチェックアウトした状態（通常のケース。チーム内のレビュー流れに乗る）か、リポジトリにアクセスできない場合は完成したファイルをユーザーに渡します。ユーザーが指定していないプラグインには書き込まないでください。
運用ガイド（ランブック）と構成図ドキュメント — これらは独立した形式とスキルを持つコンテンツで、人が読む知識です。スキルはエージェント向けの指示であり、人向けの知識ではありません。また、保有するすべてのプラグインを一度に確認する作業（「スキル全体は健全か？」）は別のスキルが担当します。このスキルは1つのスキルを、その実績データから改善します。
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 and architecture 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.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。