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 (single file or directory) to Codex for critique focused on: drift between docs and code, missing coverage, broken or suspect links, contradictions between docs.
/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*$docs/); negative lookahead prevents matching --diff-base or --resume as a path--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 --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.
--resume <path> (explicit): if validation fails, bridge returns ok:false, no fresh run, stderr note. Surface the error verbatim.--resume / --resume auto: if validation fails, bridge falls back to fresh run, writes artifact with codex-resume-status: fallback, stderr note.ok:false — NOT fallback. Tell user to narrow scope.From Group 1 (or default docs/). Verify the path exists first via Bash ([ -e "<path>" ]).
| Group 1 value | Bridge argv |
|---|---|
| Empty | ['docs-review', '--docs-dir', 'docs/'] |
Path ending in .md that exists | ['docs-review', '--docs-path', '<path>'] |
| Existing directory path | ['docs-review', '--docs-dir', '<path>'] |
| Anything else | Tell user the contract, ask to clarify, STOP. |
Use the Bash tool with timeout: 600000. 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.
Parse JSON. 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 (--docs-path to a single file, 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: 1slug (derived from file basename or dir name)generated (ISO timestamp)plugin-versioncodex-versiondocs-target (the reviewed path, JSON-stringified)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.
/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. NOT style or prose quality — that's the documenter agent's domain.
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.