review-claudemd

You can audit CLAUDE.md instructions by analyzing conversation history stored in ~/.claude/projects/ to identify instruction violations, missing patterns, and outdated entries. This generates a structured report with suggested edits for both global and project-level CLAUDE.md files.

Improving prompt quality in CLAUDE.md involves analyzing recent chat patterns to surface actionable improvements. The skill differentiates between global (~/.claude/CLAUDE.md) and local project files to propose targeted updates based on actual user conversations.

Yes, you need jq installed to parse the conversation history data required for auditing CLAUDE.md files. The tool uses jq to process conversation logs stored in ~/.claude/projects/ before generating improvement reports.

Yes, you can audit both global (~/.claude/CLAUDE.md) and local project-level CLAUDE.md files. The review process differentiates between the two scopes and proposes targeted updates for each based on detected conversation patterns.

CLAUDE.md files accumulate outdated entries or miss necessary patterns when conversation behaviors evolve without corresponding documentation updates. Auditing recent chats surfaces these gaps by comparing actual user interactions against existing instructions to generate recommended edits.

A CLAUDE.md audit report includes identified instruction violations, missing conversational patterns, and outdated content. It provides a structured overview with suggested edits to improve both global and local CLAUDE.md files based on conversation history analysis.