Review Claudemd

Spins up parallel Claude Sonnet subagents to analyze your conversation history and suggest improvements to both your global and project-specific CLAUDE.md files. It extracts recent conversations from ~/.claude/projects/, batches them by size, and has each subagent look for violated instructions, missing patterns, and outdated rules. The output groups findings into what needs reinforcement, what should be added locally versus globally, and what might be stale. Honestly most useful after you've noticed yourself repeating the same corrections across sessions. The batching logic is smart about conversation size, and the multi-agent approach means you're not waiting forever to process weeks of chat logs.

skills.sh installs: 239
GitHub stars: 10.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add ykdojo/claude-code-tips --skill review-claudemd --agent claude-code

Installs into .claude/skills of the current project.

Files

Review CLAUDE.md from conversation history

Analyze recent conversations to improve both global (~/.claude/CLAUDE.md) and local (project) CLAUDE.md files.

Step 1: Find conversation history

The project's conversation history is in ~/.claude/projects/. The folder name is the project path with slashes replaced by dashes.

# Find the project folder (replace / with -)
PROJECT_PATH=$(pwd | sed 's|/|-|g' | sed 's|^-||')
CONVO_DIR=~/.claude/projects/-${PROJECT_PATH}
ls -lt "$CONVO_DIR"/*.jsonl | head -20

Step 2: Extract recent conversations

Extract the 15-20 most recent conversations (excluding the current one) to a temp directory:

SCRATCH=/tmp/claudemd-review-$(date +%s)
mkdir -p "$SCRATCH"

for f in $(ls -t "$CONVO_DIR"/*.jsonl | head -20); do
  basename=$(basename "$f" .jsonl)
  # Skip current conversation if known
  cat "$f" | jq -r '
    if .type == "user" then
      "USER: " + (.message.content // "")
    elif .type == "assistant" then
      "ASSISTANT: " + ((.message.content // []) | map(select(.type == "text") | .text) | join("\n"))
    else
      empty
    end
  ' 2>/dev/null | grep -v "^ASSISTANT: $" > "$SCRATCH/${basename}.txt"
done

SKILL.md on GitHub