Agents md sync

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

Skills for any AI agent harness, by Mad House

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.

What its author says it does

Copied from the file, not written here

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".

SKILL.md

1.4 KB, 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