Skip to main content
affpapa.org
RU EN
skill CX Codex

review-claudemd — Claude Code skill: review history and install

This skill examines recent chats and suggests changes to global and project-level CLAUDE.md files. Use it to spot repeated instruction failures and stale rules.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add ykdojo/claude-code-tips --skill review-claudemd -a claude-code
Open on GitHub

What review-claudemd does

The skill gathers recent chat logs from ~/.claude/projects/, skips the current conversation, and gives batches to subagents alongside the global and local CLAUDE.md. The agents look for rules that were broken, project-specific or general guidance to add, and entries that may be out of date. Their findings are grouped into a summary, with a prompt asking whether you want draft edits.

Shell commands and jq extract the logs into a temporary directory. The review relies on access to the conversation files and both CLAUDE.md files. The documented extraction process will fail if jq is unavailable.

What it helps with

  • find CLAUDE.md rules that conversations repeatedly break
  • identify project-specific guidance for the local file
  • separate general rules for the global file
  • flag instructions that may be outdated

Example prompts for the agent

  • Review recent chats and suggest changes to the global and project CLAUDE.md files.
  • Group repeated instruction failures from the chat history by the relevant CLAUDE.md file.
  • Read the project's conversations and list guidance that may have gone stale.

How to install review-claudemd

1Skills CLI (Vercel)

npx skills add ykdojo/claude-code-tips --skill review-claudemd -a claude-code

2Manually: put the files in place

~/.claude/skills/review-claudemd/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/review-claudemd/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about review-claudemd

How do I install review-claudemd in Claude Code?

Run npx skills add ykdojo/claude-code-tips --skill review-claudemd -a claude-code. The skill is installed at ~/.claude/skills/review-claudemd/SKILL.md.

What does review-claudemd do?

It compares recent conversations with the global and project CLAUDE.md files. It groups findings into broken instructions, proposed additions, and possibly outdated guidance.

Does review-claudemd need access to conversation history?

Yes. It reads logs from ~/.claude/projects/ and uses jq to extract their contents.

Similar skills

All skills for Agent setup: memory, context, orchestration →
setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set8

version-check Helps decide whether to update Claude Code or hold back on the current build. Evaluates release risks using changelogs and issue trackers. CX Codex +1 ★ 10,273repo stars reddit-fetch This skill pulls posts and comments off Reddit through its JSON API when automated access gets blocked. Handy for research threads your agent can't reach. CX Codex +1 ★ 10,273repo stars quarter-clone This skill trims an active conversation down to its final quarter. It cuts token consumption while preserving the latest instructions and files. CX Codex +1 ★ 10,273repo stars private-github-search This skill searches public and private GitHub repositories through a local mirror. Use it when you need to locate code or files across several repositories. CX Codex +1 ★ 10,273repo stars hn-summarize A skill that pulls top Hacker News and hckrnews.com stories, fetches the linked articles, and groups the comment threads by theme. CX Codex +1 ★ 10,273repo stars handoff Creates or updates a HANDOFF.md file so an agent in a fresh session can pick up the task with full context. CX Codex +1 ★ 10,273repo stars half-clone This skill creates a new session from the later part of the current conversation. Use it when the early history is no longer needed but recent work should remain. CX Codex +1 ★ 10,273repo stars

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor