improving-instructionslisted

# Agents.md Improver Audit, evaluate, and improve agent-instruction files (AGENTS.md, CLAUDE.md, and variants) across a codebase to ensure the host agent has optimal project context. **This skill can write to agent-instruction files.** After presenting a quality report and getting user approval, it updates files with targeted improvements. ## Platform Adaptation | Capability | Claude Code | Codex | |---|---|---| | Find files | `Glob` / `Grep` | `shell` (`find`, `grep`) | | Read a file | `Read` | `shell` (`cat`) | | Edit a file | `Edit` | `apply_patch` / `shell` heredoc | | User confirmation | `AskUserQuestion` | `ask_user` / built-in approval prompt | | Shell commands | `Bash` | `shell` | The skill body refers to actions abstractly ("read the file", "apply the diff"). The host agent maps to its own tool inventory. ## Workflow ### Phase 1: Discovery Find every agent-instruction file in scope (project + user-global), dedupe symlinked pairs via `realpath`: ```bash { find . \( \ -name "AGENTS.md" \ -o -name "AGENTS.local.md" \ -o -name "CLAUDE.md" \ -o -name "CLAUDE.local.md" \ -o -name ".claude.md" \ -o -name ".claude.local.md" \ \) -not -path '*/node_modules/*' -not -path '*/.git/*' 2>/dev/null ls ~/.claude/CLAUDE.md ~/.codex/AGENTS.md 2>/dev/null } | xargs -I{} realpath {} | sort -u ``` **File Types & Locations:** | Type | Location | Purpose | |------|----------|---------| | Project-shared | `./AGENTS.md`, `./CLAUDE.md`, `