Agents md sync

Skill samhcus/skills/skills/agents-md-sync

Verify that AGENTS.md files are accurate by checking every path they reference against the actual filesystem. Reports stale paths, missing repos, and repos not mentioned in AGENTS.md. Triggers on "is agents.md accurate", "check agents.md", "sync agents.md", "verify agents.md", "agents.md drift", "update agents.md".From its SKILL.md

Install

npx -y skills add samhcus/skills --skill agents-md-sync

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

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.
3 stars3 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.

SKILL.md

1.4 KB, 273 tokens by cl100k_base, as published. Nobody here has run it

agents-md-sync

AGENTS.md cannot lie. This skill verifies every path claim it makes and reports drift.

Tools

scripts/check.sh

Reads AGENTS.md files, extracts all path references, checks each against the filesystem.

Input: TARGET_DIR=<directory to check AGENTS.md in> (default: $HOME)

Output:

{
  "file": string,
  "valid": [{path, exists}],
  "stale": [{path, expected_at}],
  "untracked": [{path, note}]
}

Workflow

Run TARGET_DIR="$HOME" bash scripts/check.sh for the root AGENTS.md
Run for ~/dev/mad-house/ and ~/dev/orinadus/ if they exist
For each stale path: propose the fix (remove the line, update the path, or note the drift)
Apply fixes only after confirming with the user

What counts as a stale reference

A path like ~/dev/mad-house/foo where foo does not exist
A tool command like ~/dev/mad-house/tooling/bar.sh where bar.sh does not exist
A repo mentioned in a workspace table that is not cloned locally

What ships with it: 1 file

2.0 KB alongside SKILL.md, 1 of them executable

scripts/

check.shruns2.0 KB