hyper-docs-review — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited hyper-docs-review (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Documentation accuracy gate. Sends docs (one or more files, or a directory) to Codex for critique focused on: drift between docs and code, missing coverage, broken or suspect links, contradictions between docs, in-doc duplicated or appended-beside claims (redundancy).
/hyperclaude:hyper-docs-review.hyper-docs-sync has edited docs and you want a Codex accuracy gate.Invocation argument: $ARGUMENTS
--resume is supported. Paths with spaces are unsupported.
Apply this regex to the trimmed $ARGUMENTS:
^((?:(?!--)\S+\s*)*)(?:--diff-base\s+(\S+))?(?:\s*(--resume)(?:\s+(\S+))?)?\s*$.md) or, if it's the sole token, an existing directory; empty defaults to docs/. Negative lookahead per-token prevents matching --diff-base or --resume as a path. Many files OR one directory — never both.--diff-base <ref> value"--resume" token (truthy when present, undefined when not)When Group 3 is '--resume' (truthy) and Group 4 is undefined, treat as --resume auto.
Valid invocations:
/hyperclaude:hyper-docs-review — reviews docs/, fresh run/hyperclaude:hyper-docs-review docs/api.md — reviews single file, fresh run/hyperclaude:hyper-docs-review README.md docs/workflow.md docs/architecture.md — reviews three files, fresh run/hyperclaude:hyper-docs-review README.md site/index.html — mixed file types (.md + .html), fresh run/hyperclaude:hyper-docs-review --resume — reviews docs/, resumes from latest artifact/hyperclaude:hyper-docs-review --resume <prev-artifact-path> — resumes from explicit artifact/hyperclaude:hyper-docs-review docs/api.md --diff-base main — single file with diff context/hyperclaude:hyper-docs-review docs/api.md --resume — single file, resume from auto/hyperclaude:hyper-docs-review docs/api.md --diff-base main --resume <prev-artifact-path> — all optionsIf the argument doesn't match the regex, ask the user to clarify and stop.
See ${CLAUDE_PLUGIN_ROOT}/references/bridge-review-calls.md for the shared --resume semantics (explicit vs auto fallback, the template-version precondition). Docs-review's identity check keys on the docs-target SET (order-insensitive — not a single scalar).
ok:false — NOT fallback. Tell user to narrow scope (fewer --docs-path files, or a smaller subdirectory).Split Group 1 on whitespace into tokens (or default to docs/ when empty). Classify each token via Bash — [ -f "<path>" ] (existing file → --docs-path) vs [ -d "<path>" ] (existing directory → --docs-dir); a token that is neither → STOP.
| Group 1 tokens | Bridge argv |
|---|---|
| Empty | ['docs-review', '--docs-dir', 'docs/'] |
One or more existing files (each [ -f ], any type) | ['docs-review', '--docs-path', '<path1>', '--docs-path', '<path2>', ...] (one flag per file, in order) |
| Single existing directory path | ['docs-review', '--docs-dir', '<path>'] |
| Anything else (mix of files and a dir, more than one directory, or a path that doesn't exist) | Tell user the contract, ask to clarify, STOP. |
Use the Bash tool with `run_in_background: true` (invocation mode: ${CLAUDE_PLUGIN_ROOT}/references/bridge-review-calls.md). Pass each argument as a separate token (no shell interpolation of user-supplied substrings):
# Single file
node "${CLAUDE_PLUGIN_ROOT}/scripts/codex-bridge.mjs" docs-review --docs-path docs/api.md
# Directory
node "${CLAUDE_PLUGIN_ROOT}/scripts/codex-bridge.mjs" docs-review --docs-dir docs/
# With diff context
node "${CLAUDE_PLUGIN_ROOT}/scripts/codex-bridge.mjs" docs-review --docs-path docs/api.md --diff-base mainIf --diff-base <ref> was matched (Group 2), append --diff-base <ref> to the argv. If --resume was matched (Group 3 truthy), append --resume <value> to the argv, where <value> is Group 4 if present, otherwise auto.
Once the bridge task completes, parse the JSON from its stdout. On ok:true, read the output file with the Read tool. On ok:false, surface the error verbatim:
docs payload exceeds 200KB → tell user to narrow scope (fewer --docs-path files, or a smaller subdirectory)no .md files in <path> → tell user the directory has no top-level markdowngit diff exceeds 500KB → tell user to use a closer --diff-base ref or omit itDocs-review files have YAML frontmatter:
mode: docs-reviewtemplate-version (sourced from the docs-review template's frontmatter)slug (derived from file basename or dir name; multi-file runs use <first>-plus-<n-1>)generated (ISO timestamp)plugin-versioncodex-versiondocs-target (a JSON STRING of the dir path in --docs-dir mode, or a JSON ARRAY of file paths in --docs-path list mode)diff-base (when --diff-base was used)codex-input-tokens, codex-cached-input-tokens, codex-output-tokens, codex-reasoning-output-tokens — each emitted independently when Codex reported that token field in usage; omitted when Codex did not emit usageFollowed by sections: ### Findings, ### Gaps, ### Broken Or Suspect Links, ### Cross-Doc Inconsistencies, ### Verdict.
Each ### Findings item includes severity (Blocker / Major / Minor), doc path, quoted stale claim, code evidence, and recommended edit. Redundancy findings replace the stale claim and code evidence with the duplicated claim (quoted once; both passages for a qualifier-beside case) and every location where it appears.
/hyperclaude:hyper-docs-review — Codex critiques documentation accuracy (this skill)/hyperclaude:hyper-docs-sync — Claude updates docs to match code (sister skill)/hyperclaude:hyper-code-review — Codex critiques code diffs/hyperclaude:hyper-plan-review — Codex critiques implementation plansScope is STRICT: accuracy / drift / completeness / broken links / cross-doc inconsistencies / redundancy (in-doc duplicated or appended-beside claims — reported Minor; deliberate cross-doc propagation exempt). NOT style or prose quality — prose polish is a direct edit; the documenter agent makes accuracy edits only.
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.