loamauditing-guidancelisted

Audit, prune, and improve agent guidance markdown files in repositories. Use when the user asks to check, audit, update, improve, or fix AGENTS.md, CLAUDE.md, or related guidance files. Adds missing commands and gotchas, removes stale entries, deduplicates, and keeps the file small and relevant. Scan for guidance files, evaluate quality against templates, output a quality report, then make targeted updates.
scchearn/loam · ★ 0 · Data & Documents · score 75

Install: claude install-skill scchearn/loam

# Agent Markdown Improver Audit, evaluate, and improve agent guidance markdown files across a codebase so future agent sessions have better project context. **This skill can write to guidance files.** After presenting a quality report, it updates `AGENTS.md`, `CLAUDE.md`, or `.claude.local.md` with targeted improvements and direct stale/duplicate pruning. ## Workflow ### Phase 1: Discovery Find all guidance files in the repository: ```bash find . \( -name "AGENTS.md" -o -name "CLAUDE.md" -o -name ".claude.local.md" \) 2>/dev/null | head -50 ``` **File Types & Locations:** | Type | Location | Purpose | |------|----------|---------| | Project root | `./AGENTS.md` | Primary shared project guidance across agent harnesses | | Claude-specific | `./CLAUDE.md` | Shared Claude-specific guidance when the repo uses it | | Local overrides | `./.claude.local.md` | Personal/local settings (gitignored, not shared) | | Package-specific | `./packages/*/AGENTS.md` or `./packages/*/CLAUDE.md` | Module-level context in monorepos | | Subdirectory | Any nested location | Feature/domain-specific context | **Default update rule:** `AGENTS.md` is the canonical guidance file — all shared guidance goes there. `CLAUDE.md` must exist but contains only `@AGENTS.md` (Claude Code's import syntax). Never write content to `CLAUDE.md` — it is an import shim, not a content file. Use `.claude.local.md` for personal preferences only. If you find a `CLAUDE.md` with content beyond `@AGENTS.md`, flag it as