Check Docs — Git skill for Claude Code

A 39-line shell script that stops a commit
when CLAUDE.md or AGENTS.md names a deleted file.

Plain sh · standard Unix tools
For projects that use CLAUDE.md or AGENTS.md

Made by Pavel Rabtsevich · @p_rabtsevich on X

Install · Example · What it checks · Limitations

Why this exists

CLAUDE.md and AGENTS.md are the files your coding agent reads before it works in your repo. They tell it where things live and how to run them.

When you delete or move a file, the build and the tests catch the code that still uses it. Nothing shows you the line in CLAUDE.md that still points to it. The agent keeps reading that line and does what it says.

`check-docs` covers the mechanical part of that gap. Before every commit it reads those two files, looks for paths and names that no longer exist, and stops the commit until you fix the line.

Install

Open Claude Code, Codex or Cursor in your repo and paste this whole block into the chat. The agent saves the script, adds it to the pre-commit setup you already have without overwriting anything, and runs it once.

Save the script at the end of this message as check-docs.sh in the repo root.
Add `sh check-docs.sh` to the repo's existing pre-commit setup.
If the repo already uses Husky, pre-c