verify-docs-findable

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

Audit whether a repo's docs actually ANSWER the questions a reader has — by spawning fresh, cheap (Haiku) agents that cold-read ONLY the docs and measuring how fast they reach the answer, whether they hit dead-ends, whether they fall back to source code, and whether they cite docs that contradict each other. Use after a doc reorg, when docs "feel scattered," or when the same confusion keeps recurring. Surfaces findability gaps (a corpus can be COMPLETE — every doc indexed — yet not FINDABLE) pl…

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/'verify-docs-findable' ] || [ -L ~/.agents/skills/'verify-docs-findable' ]; then echo 'A skill folder named verify-docs-findable 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/verify-docs-findable' && mkdir -p ~/.agents/skills && cp -R "$d"/'.claude/skills/verify-docs-findable' ~/.agents/skills/'verify-docs-findable' && 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/'verify-docs-findable' ~/.claude/skills/'verify-docs-findable' (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