review-docs

80 / 100 · Low risk

Fine to try. Some of what it can do is expected: a coding skill usually runs build and test commands.

By zernie/vigiles (GitHub) · coding · 15 stars · scanned at commit 1a1de50

Review the README or a documentation page from several real reader points of view at once. Fans out one parallel reviewer per audience — Claude Code newcomer, power user, plugin/skill author, skeptical senior engineer, non-running decision-maker — each scoring it x/5 and naming concrete, line-level fixes. Use when asked to review, critique, grade, or "get to N/5" the README or any front-door doc, or to check how a doc reads for real users. Not for code review (use /code-review for that).

Works with any agent that supports SKILL.md skills.

What this skill can do

Runs commands on your computer

The author does not mention this. It runs automatically when the plugin is installed. Expected for a coding skill.

Found in 5 places.

.claude-plugin/plugin.json, line 19"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/pre-edit.sh"
.claude-plugin/plugin.json, line 30"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/post-edit.sh"
.claude-plugin/plugin.json, line 39"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/refs-nudge.sh"

Show 2 more

.claude-plugin/plugin.json, line 48"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/eval-lock-nudge.sh"
.claude-plugin/plugin.json, line 59"command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh"

Downloads and installs other software

The author does not mention this. It runs automatically when the plugin is installed.

Found in 6 places.

hooks/eval-lock-nudge.sh, line 25printf '%s' "$INPUT" | npx vigiles hook-runtime eval-lock-nudge
hooks/post-edit.sh, line 22npx vigiles generate types 2>&1 || true
hooks/post-edit.sh, line 31npx vigiles compile 2>&1 || true

Show 3 more

hooks/pre-edit.sh, line 343. Run: npx vigiles compile
hooks/refs-nudge.sh, line 16printf '%s' "$INPUT" | npx vigiles hook-runtime refs
hooks/session-start.sh, line 30SUMMARY=$(npx --no-install vigiles lint --summary 2>/dev/null || true)

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'review-docs' ] || [ -L ~/.agents/skills/'review-docs' ]; then echo 'A skill folder named review-docs already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/zernie/vigiles' "$d" && git -C "$d" checkout --quiet '1a1de50f62f5c1093a46455488dcf6e8157c6182' -- '.claude/skills/review-docs' && mkdir -p ~/.agents/skills && cp -R "$d"/'.claude/skills/review-docs' ~/.agents/skills/'review-docs' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'review-docs' ~/.claude/skills/'review-docs' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for zernie/vigiles shows the score of its lowest-scoring skill.

SkillTrust badge for zernie/vigiles

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/zernie/vigiles.svg)](https://zalavijaysinh.github.io/skilltrust/repos/zernie/vigiles/)

Score history

Date	Version	Score
2026-11-08	`1a1de50`	80