update-claudemd
Keep your CLAUDE.md in sync with your codebase — automatically
- Author
-
Tortuga
- Launch Date
-
March 2026
- Platforms
-
Claude Code - Est. Token Cost
-
~150 tokens
Install
Copy and paste this into your terminal
$ npx skills add https://github.com/tortuga-ai/skills --skill tortuga:update-claudemd About
CLAUDE.md is the context file your AI agent reads at the start of every session. When it's stale, your agent makes bad assumptions about project structure, commands, and architecture. This skill reads your recent git commits or scans the full codebase, then surgically updates only the factual sections — project structure, key commands, architecture notes, and a recent changes summary — without touching hand-written instructions or custom rules.
How It's Used
Run it after a big refactor, after adding new scripts, or whenever you notice Claude making outdated assumptions. Pass --commits N to look at the last N commits, --since <ref> to scope to changes since a tag or branch, or --all for a full codebase scan. It shows a diff of proposed changes and asks for confirmation before writing anything.
What You Get
Diff preview — Shows exactly what will change in CLAUDE.md before writing — project structure updates, new commands, architecture changes, and a recent changes summary — so you can confirm before anything is modified
Surgical CLAUDE.md update — Rewrites only the auto-derivable sections (structure, commands, architecture, recent changes) while preserving hand-written instructions and custom rules you've added manually
Recent changes summary — Adds or replaces a Recent Changes section with up to 5 bullet points summarizing the latest commits, so your agent always knows what just shipped