agentsclimarketplace

Audit

Skill guillevc/skills/skills/living-spec/audit

Personal agent skills for Claude Code, Cursor, and other AI coding agents.

Install
npx -y skills add guillevc/skills --skill audit

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

One thing to look at

  • 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

Audit code against the living spec (ADRs and the glossary) and let the human resolve each contradiction. Use proactively whenever you write or change code that touches a documented decision, rule, or term, and after a build or before a commit/PR, even if the user doesn't ask. Also on "check for drift", "do the docs still match", "audit code vs spec", /audit, or when develop freezes. Reports; never auto-fixes. It stops and the human picks.

SKILL.md

1.7 KB, as published. Nobody here has run it

Audit

Find where the code you touched contradicts the living spec, both directions, and surface it. The human picks which side is wrong. Never auto-fix.

What counts as drift

  • ADRs: code violates a decision or rule, or an ADR asserts something the code has moved past.
  • Glossary: code uses a banned word (_Avoid_), names something off the canonical term, or uses a concept with no entry.
  • Not drift: shipped behavior no rule, decision, or term governs.

Steps

  1. Read the spec (glossary docs/GLOSSARY.md; ADRs docs/decisions/; else the agent doc; else ask). Skip superseded ADRs (a Status: superseded by ... line, or one another ADR's Supersedes: points to).
  2. Check each live spec claim against the code, both directions.
  3. Present each finding: the claim, where the spec says it, where the code diverges, the options. One finding per independently-fixable divergence. Stop for the human to pick: fix the code, or change the spec via record.
  4. Apply only the chosen resolution; re-check to confirm it's gone.

Scope. Audit only what you touched. A whole-repo sweep is reconcile, a human-invoked skill; never launch one on your own.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.