API Versioning & Backward Compatibility SKILL.md skillA
API Versioning & Backward Compatibility from s977043/river-review is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add s977043/river-review/API Versioning & Backward Compatibility@v0.1.0Pins v0.1.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- s977043/river-review
- Path
skills/upstream/api-versioning-compat/SKILL.md- Versions recorded
- 3
- Latest version
- v0.1.0, committed Jul 19, 2026
- First version recorded
- Jun 29, 2026
- Size
- 4,486 bytes
- Repository stars
- 7
- License
- MIT
Ensure API/contract changes specify versioning strategy, backward compatibility, deprecation plan, and migration guidance.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file 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）になるよう設計されているか。 - エラーコード・エラーモデルの互換性が保たれているか。 - リリースと通知 - リリースノート/通知チャネルと対象ステークホルダーが明記されているか。 …
Read the whole file at its exact version.
How to install
mdr add s977043/river-review/API Versioning & Backward Compatibility@sha256:0e8617de0b112d4bThe line at the top of this page pins the label v0.1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_23ypspctlnzirjpa)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Jun 29, 2026 and Jul 19, 2026, about one every 10 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v0.1.0 latest | 2026-07-19 | 686fcae | 4,486 B | A | view · diff |
| v0.1.0 | 2026-06-29 | 45e66bc | 4,491 B | A | view · diff |
| v0.1.0 | 2026-06-29 | b988700 | 4,507 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (4486 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
s977043/river-review · 7 stars · license MIT · pushed 2026-11-08 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_23ypspctlnzirjpa GET https://markdownregistry.com/api/v1/resolve?ref=s977043/river-review/API Versioning & Backward Compatibility GET https://markdownregistry.com/api/v1/blob/0e8617de0b112d4b2bb89303a1b6074fd18c72a3ceb71f2688175f08b1b853fe
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from s977043/river-review
Every file in s977043/river-review