Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add s977043/river-review --skill api-versioning-compatgit clone --depth 1 https://github.com/s977043/river-reviewWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/s977043/river-review/api-versioning-compat)<a href="https://agentmods.dev/skills/s977043/river-review/api-versioning-compat"><img src="https://agentmods.dev/badge/skills/s977043/river-review/api-versioning-compat/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/s977043/river-review/api-versioning-compat"><img src="https://agentmods.dev/badge/skills/s977043/river-review/api-versioning-compat.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00029 | $0.01314 |
| Opus 5.5 | $0.00012 | $0.00526 |
| Sonnet 5.5 | $0.00006 | $0.00263 |
| Haiku 4.5 | $0.00003 | $0.00131 |
Grade A, and why
API Versioning & Backward Compatibility scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
Pattern declaration
Primary pattern: Reviewer Secondary patterns: Inversion Why: API/契約変更のバージョニング・後方互換性・移行計画の記載漏れを検出し、破壊的変更の混乱を防ぐ。
Goal / 目的
- API/インターフェースの変更から、後方互換やバージョニング、非推奨/移行計画の抜けを早期に潰す。
Non-goals / 扱わないこと
- API の正解設計を断定しない（互換性と移行方針の明確化に限定）。
- 実装コードの最適化やライブラリ選定の議論。
Pre-execution Gate / 実行前ゲート
このスキルは以下の条件がすべて満たされない限りNO_REVIEWを返す。
- 差分にAPI定義・OpenAPI仕様・契約/インターフェース関連ファイルが含まれている
- 差分にAPIのフィールド・型・エンドポイント・バージョンの追加・変更・削除が含まれている
- inputContextに
diffが含まれている
ゲート不成立時の出力: NO_REVIEW: api-versioning-compat — API/契約の変更なし
False-positive guards / 抑制条件
- 自動生成ファイルのみの差分で契約の実質が変わらない場合は指摘しない（
NO_ISSUES）。 - 既に別の互換性ガイドラインを参照し、差分が参照更新のみなら重複指摘しない。
Rule / ルール
- 先頭に要約を 1 行出す（互換性影響/バージョン/移行の要点）。
- 指摘は最大 8 件。破壊的変更の有無、移行/非推奨の明示、エラーモデルの互換性を優先。
- 可能なら “移行ガイドの追記案” を付ける。
Checklist / 観点チェックリスト
- 互換性とバージョン
- 破壊的変更（型変更/フィールド削除/挙動変更）の有無と方針（後方互換 or 新バージョン発行）が明記されているか。
- バージョンスキーム（パス/ヘッダ/メディアタイプ）とクライアント影響が説明されているか。
- 非推奨と移行
- 非推奨期間、移行締切、旧バージョンのサポート範囲が書かれているか。
- 移行手順（両対応期間、ロールアウト順、ロールバック条件）があるか。
- 契約の整合
- OpenAPI/契約に追加されたフィールドが後方互換（nullable/optional）になるよう設計されているか。
- エラーコード・エラーモデルの互換性が保たれているか。
- リリースと通知
- リリースノート/通知チャネルと対象ステークホルダーが明記されているか。
- テスト/サンプル/クライアントSDKの更新が追随する計画があるか。
Output / 出力フォーマット
すべて日本語。<file>:<line>: <message> 形式で出力。
- 先頭に要約行:
(summary):1: <互換性/バージョン/移行の要点> - 指摘は最大 8 件:
<message>に[severity=critical|major|minor|info]を含める。- 可能なら “移行ガイド追記案” を 1 行付ける。
例:
docs/api/change.md:58: [severity=major] バージョン表記が未定。Fix: v1 を維持しつつ v2 をパス/ヘッダで明記し、両対応期間と切替条件を追記。
評価指標（Evaluation）
- 合格: 差分に紐づく互換性/バージョン/移行の不足を優先度付きで指摘し、追記案がある。
- 不合格: 差分と無関係な一般論、根拠のない断定、指摘過多。
人間に返す条件（Human Handoff）
- 互換性破壊やサポート期間の決定が組織/顧客契約に跨る場合は人間レビューへ。
What ships with it
2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 100 lines · 29 tokens per session scan A 0e8617de0b11
API Versioning & Backward Compatibility is a skill published in the GitHub repository s977043/river-review (4 stars, last pushed yesterday), licensed MIT. It adds 29 tokens to every session and 1,314 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.
Other skills, from other repositories
spine-review
API and backend code review — REST conventions, auth, validation, error handling, pagination, rate limiting, test coverage. Use when asked to "review this API", "code review", "review backend", or "pre-launch backend check".
Contract-First Testing
Contract-first testing approach using Pact, Spring Cloud Contract, or Dredd for ensuring API consumer-provider compatibility.
spine-api
Design and spec an API — endpoints, request/response shapes, error codes, auth pattern, pagination. Applies Stripe's consistency principles. Use when asked to "design an API", "build API endpoints", "create REST API", or "API for this feature".
spine-recon
Backend reconnaissance — map all routes, middleware, models, dependencies, auth, and assess code quality for project takeover. Use when asked to "understand this backend", "map the API", or "assess code quality".
api-integrations
Expose external APIs to Falcon Foundry via OpenAPI specs. TRIGGER when user asks to "create an API integration", "adapt an OpenAPI spec for Foundry", "expose an API to workflows", "connect to a third-party API", or runs foundry api-integrations create. Also trigger when user has an OpenAPI/Swagger spec and wants it…
nodejs-backend
Node.js backend patterns: framework selection, layered architecture, TypeScript, validation, error handling, security, production deployment. Use when building REST APIs, Express/Fastify servers, microservices, or server-side TypeScript.