Skip to main content
skill CX Codex

update-claudemd — Claude Code skill: what it does, how to install

update-claudemd — a skill that checks CLAUDE.md and the topic files in .claude/rules/ against the actual code and commit history, then trims what went stale and regroups the instructions.

no license ★ 276 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add gupsammy/Claudest
/plugin install claude-coding@Claudest
Open on GitHub

What update-claudemd does

The skill re-checks a project's CLAUDE.md and everything under .claude/rules/*.md against what the repository holds now, plus commits made after each file was last touched. Structure follows progressive disclosure: the root file keeps project identity, invariants shared by most tasks, and pointers; narrow notes move into topic files.

Before reading any code it sizes the job. How many commits landed since the last CLAUDE.md edit, and how many files git tracks, decide how many shards the scan gets, capped at 4. Then 3 + N Explore agents start at once. One classifies every section and looks for dead paths, wrong commands and duplicated text. Another replays git log for each instruction file separately. Limits are advisory: roughly 120 lines for CLAUDE.md with 150 as the ceiling, about 300 per topic file, and an overage gets flagged rather than blocked.

Every topic file it writes has to carry paths: in the frontmatter, because files in .claude/rules/ otherwise load at SessionStart in every session. No CLAUDE.md at the repo root means the skill stops instead of generating one. A git repository is required too, since each staleness window starts at that file's own commit date. The user-level ~/.claude/CLAUDE.md is left alone.

What it helps with

  • sync CLAUDE.md with code that moved since the last edit
  • strip dead paths and stale commands from project instructions
  • split an oversized CLAUDE.md into files under .claude/rules/
  • spot duplicated guidance between the root file and its topics
  • catch topic files that nothing links to from the index

Example prompts for the agent

  • Update CLAUDE.md, it drifted away from the codebase.
  • Reorganize CLAUDE.md and move subsystem notes into topic files.
  • Audit .claude/rules/ and sync those files with the code.

How to install update-claudemd

1Plugin marketplace

/plugin marketplace add gupsammy/Claudest
/plugin install claude-coding@Claudest

This installs the whole claude-coding plugin with all its skills

2Skills CLI (Vercel)

npx skills add gupsammy/Claudest --skill update-claudemd -a claude-code

3Manually: put the files in place

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

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

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

Questions about update-claudemd

How do I install update-claudemd in Claude Code?

From the marketplace: run /plugin marketplace add gupsammy/Claudest, then /plugin install claude-coding@Claudest.

What does update-claudemd do?

It compares CLAUDE.md and the files in .claude/rules/ with the code and git history, removes what went stale, and sorts the instructions into topic files carrying paths: frontmatter.

What does the skill need to run?

A git repository with commit history and an existing CLAUDE.md at the project root. Without that root file the skill stops and will not create one.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set47

The whole set →
create-claw-skill create-claw-skill is a Claude Code skill for creating OpenClaw skills or slash commands and adapting Claude Code skills. It helps prepare a SKILL.md with platform-specific fields and instructions. CX Codex +1 ★ 276repo stars repair-agent repair-agent runs an existing agent file through seven dimensions, reports what is broken and what is missing, then hands back a plan of edits. CX Codex +1 ★ 276repo stars setup-github-actions setup-github-actions generates repository GitHub Actions pipelines wired to the Anthropic runner with least-privilege permissions. CX Codex +1 ★ 276repo stars generate-image generate-image — a Claude Code skill that creates and edits images through generate.py — logos, stickers, product mockups, t2i, i2i and multi-reference composites. It kicks in when you need a finished visual, not markup. CX Codex +1 ★ 276repo stars repair-skill repair-skill audits existing Claude Code skills against reference specs to spot frontmatter flaws, missing permissions, and syntax gaps. CX Codex +1 ★ 276repo stars claude-claw claude-claw is a Claude Code plugin that configures OpenClaw and authors custom skills. It looks up official documentation, inspects gateway health, and ports existing commands. ★ 276repo stars claude-content The claude-content plugin for Claude Code bundles seven skills for video compression and conversion, GIFs, social clips, audio and frame extraction, and Gemini image generation. ★ 276repo stars claude-thinking claude-thinking runs guided interviews to define requirements and convenes parallel agent councils to critique architectural decisions. ★ 276repo stars

Project sponsors

Companies that keep this analytics open