スキルを追加する（最短手順）

River Review に新しいスキル（skills/**/*.md）を追加して、検証し、ローカルで動かすまでの 最短パス をまとめます。

より詳しい書き方（アンチパターン、Evidence、Non-goals、誤検知ガードなど）は pages/guides/write-a-skill.md を参照してください。

0) 前提

スキルを置く場所は category × first-party / community の 2 軸で決まります。

スキルの category フィールドと同名のディレクトリに置きます（例: category: midstream → skills/midstream/）。

配置	対象
`skills/midstream/` (直下)	コアメンテナーが管理・評価した第一級スキル。`recommended: true` が基本
`skills/midstream/community/`	外部コントリビューター由来、またはサードパーティのライブラリ・フレームワーク固有のスキル。`recommended: false` がデフォルト

community/ に置く目安（いずれか 1 つでも該当すれば community）:

community スキルはフィクスチャと golden output を揃えると recommended: true 昇格の候補になります（詳細: pages/guides/governance/skill-policy.md）。

決定例:

skills/_template.md をコピーして、選んだディレクトリに配置する。
- 例 (first-party): skills/midstream/my-skill.md
- 例 (community): skills/midstream/nextjs-my-skill/SKILL.md
YAML frontmatter を最低限埋める（必須フィールドは schemas/skill.schema.json を参照する）。
- id: 一意な ID（例: my-skill）
- name: スキル名
- description: 何を検知/指摘するか（短く）
- category: core / upstream / midstream / downstream のいずれか（ルーティングの第一キー）
- applyTo: 対象ファイルの glob（まずは狭めるのが推奨）。files / path_patterns も別名として利用可能。
- phase: 後方互換が必要な場合のみ併記する（新規スキルでは category のみで十分）

メタデータの詳細定義は pages/reference/metadata-fields.md を参照してください。

npm run skills:validate

失敗したら、エラーメッセージに出るフィールド（必須欠落/enum 不一致など）を修正して再実行します。

LLM を使わずにまず動作確認する場合（再現性重視）:

river run . --phase midstream --dry-run --debug --context diff,fullFile

ポイント:

applyTo が変更ファイルにマッチしないと、そのスキルは選ばれない。
inputContext を付けている場合、--context に含まれないとスキップされる。
- 迷う場合は、まず inputContext: [diff] から始めるのが安全である。