update-claude-md

Installation
SKILL.md

Update CLAUDE.md

Refresh the CLAUDE.md that scopes the user's current working directory so its claims match the code today.

Scope rules

  • Target file: the closest CLAUDE.md to cwd walking upward. Prefer the app/package-level file when cwd is inside one; only touch the monorepo root CLAUDE.md when cwd is at the root (or no package-level file exists).
  • Never invent a CLAUDE.md. If none exists in scope, stop and tell the user.
  • Never touch ~/.claude/CLAUDE.md (global user instructions) or other packages' CLAUDE.md files — single-package scope only.
  • ## Task-specific plan / scratch sections: prune, don't preserve. Entries for work that already landed are cruft — remove them (see the task-cruft sweep in step 5). Keep only entries for tasks still in flight; when you can't tell, keep and flag in the summary.

Detect progressive-disclosure structure

Before doing anything else, check whether the target CLAUDE.md is a thin index that defers deep content to a context/ (or similar) directory of sibling .md files. Signals:

  • A sibling directory named context/, claude/, docs/claude/, or similar containing multiple *.md files.
  • The CLAUDE.md body references those files (e.g. a "Where to read deeper" / "Load on demand" table mapping topics → file paths).
  • The CLAUDE.md itself is short (orientation only) and explicitly says deeper docs live elsewhere.
Installs
3
Repository
zkmake/skills
GitHub Stars
2
First Seen
Aug 11, 2026