What problem does it solve? Agent instruction files in a repository often end up broken, half-finished, or drifted: a setup run failed partway, CLAUDE.md or AGENTS.md is thin or missing sections, unfilled {{PLACEHOLDER}} text remains, AGENTS.md is a symlink, or the two files disagree. This Skill audits the repo against the target state defined by the setting-up-a-project skill and repairs only the gaps, preserving decisions already recorded. ## Core Features & Use Cases - 15-Point Audit Table: Runs checks covering file existence, symlink defects, placeholder text, verbatim rule-file diffs, cross-file agreement, and whether documented commands actually run, recording PASS / FAIL / N-A before touching anything. - Delta-Only Repair: Merges missing sections into existing files instead of overwriting, restores verbatim rule files (TDD.rules.md, git-commit-rules.md, CLAUDE-specific-fuckups.md) from canonical sources, and fills gaps from repo evidence like manifests, lockfiles, and CI workflows. - Verify-Then-Report Loop: Re-runs the full audit after repairs and produces a before → action → after report with every assumption recorded. - Use Case: A repo's AGENTS.md is a symlink and CLAUDE.md documents a test command that fails. The Skill detects both defects, replaces the symlink with a real file, fixes the phantom command row, and commits each repaired area separately. ## Quick Start Audit this repository's agent setup against the setting-up-a-project specification and repair any gaps you find.
