oh79

Agent Context Check — Documentation skill for Claude Code

Documentation community

Offline, zero-dependency checks for broken local Markdown links in AGENTS.md, CLAUDE.md and SKILL.md.

How to install Agent Context Check

This entry records only its repository, not the path inside it, so there is no exact command to give. Open oh79/agent-context-check and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agent Context Check does

Offline, zero-dependency checks for broken local Markdown links in AGENTS.md, CLAUDE.md and SKILL.md.

Alternatives in Documentation

Repo Recap — Generate a structured recap of the repository state: open PRs, open issues, recent releases, and executive sum 11.9k ★
Cog — 240+ Cognitive architecture for Claude Code -- persistent memory, self-reflection, and foresight via plain-tex 294 ★
Context Forge — CLI tool that scaffolds context engineering documentation for Claude Code projects 137 ★

README

agent-context-check

[![CI](https://github.com/oh79/agent-context-check/actions/workflows/ci.yml/badge.svg)](https://github.com/oh79/agent-context-check/actions/workflows/ci.yml) [한국어](README.ko.md) · [MIT](LICENSE)

**Catch skill references that work in source but disappear from the package you ship.**

An agent can receive `SKILL.md` while its `references/` or `scripts/` files are left behind by packaging or installation. Compare the source and the prepared distribution directory before publishing. Findings point to the instruction file and line, and distinguish a broken source reference from a file missing in the artifact.

**Zero dependencies. Node.js 20+. Offline. Read-only. No API key.**

Compare a source and a distribution

npx --yes agent-context-check@0.2.0 compare --source ./skill --artifact ./dist/skill

Use the same relative layout in both roots. For a tarball with a top-level `package/` folder, pass the unpacked `package/` directory as the artifact. Create or unpack the artifact with your normal build tools first. The checker never installs a skill, runs its commands, or extracts an archive.

# Machine-readable findings
npx --yes agent-context-check@0.2.0 compare --source ./skill --artifact ./dist/skill --json

# Optional instruction files, relative to the source root
npx --yes agent-context-check@0.2.0 compare --source ./skill --artifact ./dist/skill SKILL.md

The tool checks instruction files themselves and referenced local targets. A missing `SKILL.md` in the artifact is an error, even if its referenced files are present. Existing file/directory types must agree. This checks availability and type, not byte-for-byte equality or whether the artifact's instructions changed.

References supported in comparison mode

Local Markdown links, images, and reference links in discovered AGENTS.md, CLAUDE.md, and SKILL.md files.
Explicit literal paths under references/, scripts/, and assets/ in inline code.
Literal `$