claude-md-updater
Installation
SKILL.md
Project instruction updater
Analyze the current conversation to identify information worth persisting in the project's instruction file, then propose the edits for approval before writing anything.
Resolve the target before drafting:
- If
AGENTS.mdexists, update it. In Claude Code, if there is noCLAUDE.md, also propose a one-lineCLAUDE.mdimport of@AGENTS.md. Claude Code loadsCLAUDE.md, notAGENTS.md. - If only
CLAUDE.mdexists, update it. - If both exist and either imports the other, update the imported canonical file.
- If neither exists, create
AGENTS.md. In Claude Code, also propose the one-lineCLAUDE.mdimport.
What to look for
1. Hard-won lessons
- Debugging sessions that revealed non-obvious causes
- Workarounds for platform or tool limitations
- Anti-patterns discovered through failure
- "The real problem was..." moments