AGENTS.md / CLAUDE.md Improver

Audit, evaluate, and improve project-rules files across a codebase to ensure the agent has optimal project context.

OpenCode reads project rules from several files in a priority order: AGENTS.md (native), then CLAUDE.md (Claude Code compatibility), then .agents/instructions.md. This skill works on whichever your project uses, but treats AGENTS.md as the canonical name when creating new files.

This skill can write to project-rules files. After presenting a quality report and getting user approval, it updates the files with targeted improvements.

Workflow

Phase 1: Discovery

Find all relevant files in the repository:

find . \( -name "AGENTS.md" -o -name "CLAUDE.md" -o -name ".claude.local.md" -o -name ".agents.local.md" \) 2>/dev/null | head -50

File types and locations: