river-review-docs

river-review-docs is a skill for Claude Code from s977043/river-review. It costs 73 tokens per session (1,244 once invoked), scanned A, original, MIT.

A documentation review guide for checking whether project instructions and documentation match the code. It also compares Japanese and English documentation and checks that important terms are used consistently.

In plain words
What is it for?
Reviewing README files, documentation, AGENTS.md files, CLI options, API descriptions, configuration keys, code examples, translations, and product terminology.
Why use it?
It helps prevent users from following outdated commands, incorrect settings, broken examples, or instructions missing from one language. It catches differences between what the documentation promises and what the software actually does.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions AGENTS.md.

Part of the river-review plugin — 138 skills, 18 commands, 5 agents, 3 hooks shipped together

Good fit Reviewing README files, documentation, AGENTS.md files, CLI options, API descriptions, configuration keys, code examples, translations, and product terminology.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/s977043/river-review/river-review-docs
Install

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.

Any agent
npx skills add s977043/river-review --skill river-review-docs
Clone the repo
git clone --depth 1 https://github.com/s977043/river-review

Made for: Claude Code.

Or install river-review, the plugin that ships this one along with the rest of its 138 skills, 18 commands, 5 agents, 3 hooks.

Wrote 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.

agentmods badge for river-review-docs

README.md
[![agentmods](https://agentmods.dev/badge/skills/s977043/river-review/river-review-docs/github.svg)](https://agentmods.dev/skills/s977043/river-review/river-review-docs)
Your own site
<a href="https://agentmods.dev/skills/s977043/river-review/river-review-docs"><img src="https://agentmods.dev/badge/skills/s977043/river-review/river-review-docs/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.

agentmods 80×15 button for river-review-docs

Your own site · 80×15
<a href="https://agentmods.dev/skills/s977043/river-review/river-review-docs"><img src="https://agentmods.dev/badge/skills/s977043/river-review/river-review-docs.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 73 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,244 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00073 $0.01244
Opus 5 $0.00036 $0.00622
Sonnet 5 $0.00015 $0.00249
Haiku 4.5 $0.00007 $0.00124

Measured 10d ago against content hash e3319ef44edb, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

river-review-docs 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 10d 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.

skills/agent-skills/river-review-docs/SKILL.md · 62 lines

What it actually says

Documentation Review(ドキュメントレビュー)

ドキュメントと実装の整合性、翻訳パリティ、用語統一を検証する。

When to Use / いつ使うか

  • README / docs / AGENTS.md / ガイドの変更時
  • コードの公開インターフェース(CLI フラグ、API、設定キー)が変わったが、対応するドキュメントが更新されていない可能性があるとき
  • 多言語(JA/EN)ドキュメントの一方のみが更新されたとき
  • 用語・命名(プロダクト名、コマンド名など)の揺れが疑われるとき

Review Viewpoints / レビュー観点

  1. 実装との整合性: ドキュメントが記述するコマンド・フラグ・設定キー・パス・バージョンが、実際のコード(CLI ヘルプ、設定スキーマ、ソース)と一致しているか。古い・誤った記述を検出する。
  2. API ドキュメントとコードの対応: 公開関数・スキーマ・出力フォーマットの説明が実装と一致しているか。欠落した項目(未文書化のフラグ・コマンド・設定)を検出する。
  3. usage / 例の正確性: コード例・コマンド例がそのまま実行可能か。存在しないファイル・廃止された手順を参照していないか。
  4. i18n 整合性: JA/EN のペアで、一方にあるセクション・表・注記が他方に欠落していないか。バージョンピンや手順の食い違いがないか。
  5. 用語統一: プロダクト名・コマンド名・固有名詞の表記が統一されているか(例: 旧称の残存)。

Output / 出力

他の専門スキルと同じ finding 契約に従って出力する。各 finding には以下を含める。

  • severitycritical / major / minor / info)/ file / line / message(Finding 本文)
  • impact: そのドキュメント不整合が読者・利用者に与える影響
  • fix: 推奨する修正(どのドキュメントをどう直すか)
  • evidence: ドキュメントと実装の不一致では、対応する実装側の根拠(ファイル・行・該当記述)
  • confidence: 確信度(推測が含まれる場合は明示する)

差分に存在しない箇所への推測に基づく指摘は行わない。

Notes / 注意

  • 文章スタイル(textlint / markdownlint)の機械的チェックは既存の lint が担うため、本スキルは内容の整合性に集中する。
  • 多言語パリティの指摘では、SSoT(通常は JA)を基準に欠落を示す。
  • レンダリング文脈を無視したリンク形式の指摘はしない(#1464 / #1493)。pages/ 配下から repo 内の非公開領域(skills/ / docs/ など)への絶対 GitHub URL は Docusaurus 配信の制約による意図的選択であり、相対化を提案しない。逆に skills/ から docs/ への参照は相対リンクが正典(#1494)。bare #N 化は .md レンダリングで常に非リンク化するため、一律で簡約の提案を禁止する。詳細と canary は doc-hygiene の「False-positive guards」を参照。
  • 観点5(用語統一)で severity の内部語彙とスキーマ語彙を混同しない(#1502)。SKILL.md 内の blocker / warning / nit と出力スキーマの critical / major / minor.claude/rules/review-core.md が定義する意図的な二層語彙であり、「表記揺れ」として一方への統一を提案しない。詳細と canary は doc-hygiene の「False-positive guards」を参照。
Files

What ships with it

1 file 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.

Changes

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.

  1. 10d ago First seen · 62 lines · 73 tokens per session scan A e3319ef44edb

Subscribe to this mod's changes

river-review-docs is a skill published in the GitHub repository s977043/river-review (3 stars, last pushed today), licensed MIT. It adds 73 tokens to every session and 1,244 once invoked, about $0.0004 per session on Opus 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-08-31.

Related

Other skills, from other repositories

han-release

Cut a Han release: update CHANGELOG.md with the changes since the last release, bump and tag every plugin that changed as {plugin-name}--v{version} so a version-constrained dependency can resolve, and publish a GitHub release crediting every merged pull request and closed issue to the people behind it. Use when…

testdouble/han · 172 tokens

spike-consumer-baseline

OI-3 spike harness — heavy consumer skill, BASELINE arm. Builds an incident post-mortem and sources the readability standard mid-workflow by reading a file directly, with NO Skill-tool call. Use only when explicitly invoked by the spike harness with a TRIALID and data path.

testdouble/han · 66 tokens

spike-consumer-adversarial

OI-3 spike harness — heavy consumer, ADVERSARIAL arm. Worst-case early-exit test: the mid-workflow Skill call has no continuation guardrail and the guidance skill ends with a final-sounding anchor. Use only when explicitly invoked by the spike harness with a TRIALID and data path.

testdouble/han · 0 tokens

spike-guidance-inline

OI-3 spike harness — the INLINE (non-forked) readability-guidance variant. Surfaces the shared readability standard into the calling skill's own context. Use only when a spike consumer skill invokes it.

testdouble/han · 49 tokens

spike-probe

Internal harness probe for the OI-3 readability-guidance spike. Use only when explicitly told to invoke spike-probe. Verifies that a freshly-created project skill renders into a subagent's context via the Skill tool.

testdouble/han · 50 tokens

audit

Audit a documentation-led repo against its own conventions — contiguous ADR numbering, INDEX sync, plan/ coverage, required sections, status validity, cross-reference resolution, language mandate, ADR-privacy leaks into user-visible code, cross-worktree collisions (duplicate numbers, duplicate plan ownership, same ADR…

EvolveHQ/docflow · 141 tokens