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 doc-hygienegit 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/doc-hygiene)<a href="https://agentmods.dev/skills/s977043/river-review/doc-hygiene"><img src="https://agentmods.dev/badge/skills/s977043/river-review/doc-hygiene/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/doc-hygiene"><img src="https://agentmods.dev/badge/skills/s977043/river-review/doc-hygiene.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.00097 | $0.02299 |
| Opus 5 | $0.00048 | $0.01149 |
| Sonnet 5 | $0.00019 | $0.00460 |
| Haiku 4.5 | $0.00010 | $0.00230 |
Grade A, and why
Documentation Hygiene ドキュメント衛生 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 6d 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.
How it starts
The opening of the file, as written. The whole thing — 102 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Pattern declaration
Primary pattern: Reviewer Secondary patterns: Inversion Why: ドキュメントの役割汚染・内部メモ混入はパターン的に拾える部分が多いが、恒久 SOP と一過性ログのどちらなのかという文書の意図の判断が要る。ドキュメント差分を含まない変更では実行を止めるゲートが必要。
Goal / 目的
- 恒久ドキュメント（
AGENTS.md/ SOP / ガイド）に、一過性のタスクログ・特定 PR 固有の作業記録が混入していないかを検出する。 - SOP / decision / log / learned の役割が混同されていないか（手順書に決定記録や日次ログを混ぜるなど）を検出する。
- 公開物（README / docs / 記事）に、内部メモ・ローカルパス・AI との会話断片・デバッグ出力が残っていないかを検出する。
Non-goals / 扱わないこと
- ドキュメントと実装の整合性（
river-review-docsルーターの領域）。 - 日本語の文体・textlint 的な体裁（lint の領域）。
- 翻訳パリティ（ja/en の対応漏れは docs 系の別観点）。
- 記事そのものの技術的正しさや SEO（article-reviewer の領域）。
Pre-execution Gate / 実行前ゲート
このスキルは以下の条件がすべて満たされない限り NO_REVIEW を返す。
- 差分にドキュメントファイル（
*.md/*.mdx/AGENTS.mdなど、恒久ドキュメントまたは公開物）の追加・変更が含まれている - inputContext に diff が含まれ、
code_search（grep）が利用可能である
ゲート不成立時の出力: NO_REVIEW: doc-hygiene — ドキュメントの変更が検出されない
False-positive guards / 抑制条件
- 一過性ログを意図的に置く場所（
CHANGELOG.md/docs/**/retrospectives/**/_docs/decisions/**/ 日付付きログファイル）への追記は、その役割に沿う限り指摘しない。 - 手順書内のコマンド例・出力例として意図的に引用されたログは指摘しない（地の文に紛れ込んだ作業ログのみ対象）。
- ローカルパスでも、汎用的な例示（
/path/to/...、~/project）は指摘しない。実在の個人パス（/Users/<name>/、/home/<name>/、C:\Users\<name>\）のみ対象。 - 内部向けと明記されたドキュメント（先頭に「内部資料」等の宣言がある）への内部メモは、公開物でない限り指摘しない。
- リンクの絶対/相対はリンク元の配布文脈で正誤が逆転するため、一律の変換提案はしない（#1464 / #1493）。
pages/（Docusaurus 公開ルート）配下から repo 内の非公開領域（skills//docs/など Docusaurus で配信されないパス）への参照は、絶対 GitHub URL が正典であり、相対化すると公開サイトで 404 になる。逆にskills/配下（plugin バンドルにdocs/が同梱される）からdocs/への参照は相対リンクが正典（#1494）。相対化・絶対化のどちらを提案する前にも、リンク元ディレクトリの配布経路（Docusaurus 公開 or plugin バンドル同梱）を確認し、「repo 内リンクは常に相対化すべき」という一律ルールを適用しない。 [#N](URL)を bare#Nへ簡約する提案はしない（#1464）。bare#Nの自動リンクは GitHub の issue / PR 本文だけの仕様であり、レンダリングされた.md（Docusaurus / GitHub のファイルビュー）ではプレーンテキストになるため、一律で簡約の提案を禁止する。- SKILL.md 内の severity 内部語彙（
blocker/warning/nit）を出力スキーマ語彙（critical/major/minor）へ統一する提案はしない（#1502）。.claude/rules/review-core.md「Severityの語彙マッピング」が定義するとおり、SKILL.md（LLM プロンプト向け内部語彙）と出力 JSON スキーマ（正規化後語彙）は意図的に異なるボキャブラリを使う二層構造であり、写像は既に規約として定義済み。両者の語彙差を「表記揺れ」と誤認し、どちらか一方に統一する提案をしない。
What ships with it
3 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.
- 6d ago First seen · 102 lines · 97 tokens per session scan A 639eea449fd4
Documentation Hygiene ドキュメント衛生 is a skill published in the GitHub repository s977043/river-review (3 stars, last pushed today), licensed MIT. It adds 97 tokens to every session and 2,299 once invoked, about $0.0005 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-09-03.
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…
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.
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.
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.
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.
brainstorm
You MUST use this skill before /pm when work is ambiguous, scope is unclear, or multiple approaches exist. Explores problem space, proposes 2-3 approaches with trade-offs, and produces an approved spec document that feeds into both issue creation (/pm) and implementation planning (/cdt). Triggers: brainstorm, explore…