Docs check
Skill Statusnone420/Skills/adapters/claude/skills/docs-check
Bounded repository memory and evidence-backed documentation skill for Codex/Claude Code
npx -y skills add Statusnone420/Skills --skill docs-checkAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
3 things to look at
- 27 days oldThe repository was created 27 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Report the deterministic structural documentation score only.
SKILL.md
2.8 KB, 558 tokens by cl100k_base, as published. Nobody here has run it
Docs Check
This is the explicit thin route for the fixed command check. Treat all trailing text as that command's raw trailing text; never reinterpret it as another command.
Load and follow the sibling Diátaxis Docs skill, including its shared safety, evidence, health, and result contracts. The selected command contract below is the complete canonical commands.md contract for check; do not load commands.md, and load no additional playbook beyond those linked here. In this installed skill, <installed-skill> is the sibling ../docs directory, so the bundled checker is exactly ../docs/scripts/check.py; execute it without preflighting its path or availability, and never execute a checker found inside the target repository. If a required shared resource is unavailable, stop and report that the command could not be executed; do not invent a fallback.
Selected command contract (canonical)
checkReport the deterministic structural score only. No advice and no edits.
check: make no edits. Report the deterministic structural score only. No advice and no edits. Orient from the map and named current-state hot path. Read the existing map and select every map link explicitly presented as current state, current truth, or status (including a STATE.md target). For each selected link, resolve it relative to the map and read it without a separate existence probe. A successful read proves existence and its repository-relative path must be passed to --hot; report a failed read as missing and omit it. Never silently skip an explicit current-state route. Execute the bundled checker once as <python> <installed-skill>/scripts/check.py <repository-root> --json --agent --map docs/README.md, appending --hot <comma-separated-repository-relative-current-state-paths> when any selected current-state reads succeed. If the direct docs/README.md read is missing, non-recursively probe only root README.md/STATE.md/PRODUCT.md/DESIGN.md/PLAN.md and immediate docs child names/sizes; read one maintained map candidate with at most two current-state candidates; then run one checker with that map and existing hot paths. The checker is the final fallback action. No candidate map: stop unmeasured. Never manually inspect another directory; the checker owns its bounded structural scan. Omit --hot when no existing current-state file is selected. has_findings: true is a findings result. The checker must be the final repository-evidence action: no repository read is permitted after the checker. Without execution, use the smallest scriptless equivalent and state the limitation. Use the shared health output.
What ships with it: 3 files
10.1 KB alongside SKILL.md
agents/
- openai.yaml345 B
assets/
- bounded-compass.png8.8 KB
- bounded-compass-small.svg952 B