self-update

Update CLAUDE.md with corrections, preferences, and architectural insights.

20|5|Updated Feb 27, 2026

Search Tags:#workflow #documentation #preferences #gotchas #claude-md #living-document #self-update

Ready to run

npx skills add https://github.com/nasrulhazim/agent-skills --skill self-update-nasrulhazim

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: self-update
Source: https://github.com/nasrulhazim/agent-skills/tree/main/skills/self-update
Command: npx skills add https://github.com/nasrulhazim/agent-skills --skill self-update-nasrulhazim

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CLAUDE.md is a living document that must reflect a project's evolving decisions, corrections, and preferences. This skill ensures CLAUDE.md is updated immediately whenever a new correction, preference, better pattern, or gotcha is discovered, so guidance stays accurate across future sessions.

Core Features & Use Cases

Automatic in-session updates to CLAUDE.md when corrections, preferences, patterns, or gotchas are identified.
Guided Update Procedure to insert changes in the correct sections (Preferences, Gotchas, Architecture, etc.) without breaking existing content.
Supports contributing to CLAUDE.md from ongoing sessions across multiple projects.

Quick Start

State a correction or preference when you want CLAUDE.md updated; Claude will apply the update immediately.

Frequently Asked Questions about self-update

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I keep CLAUDE.md updated automatically during active coding sessions?▼

Update CLAUDE.md automatically by stating a correction or preference during your session. The skill immediately applies changes to the appropriate sections, ensuring your living document stays current without manual editing.

What is a living CLAUDE.md document and when do I need to maintain it?▼

A living CLAUDE.md document captures a project's evolving decisions, corrections, and preferences. You need to maintain it when ongoing sessions generate new architectural insights or gotchas that must be preserved for future context.

How to add new architectural insights and preferences to CLAUDE.md without breaking existing content?▼

Add new architectural insights by triggering the guided Update Procedure. It validates formatting and inserts changes under correct sections like Preferences or Gotchas, avoiding disruptiveness to existing document content.

Can I use this workflow to capture gotchas and corrections across multiple projects?▼

Yes, you can contribute to CLAUDE.md from ongoing sessions across multiple projects. The skill standardizes how corrections and preferences are captured, preserving decisions across all your active project sessions.

Does updating CLAUDE.md require any specific dependencies or external components?▼

Updating CLAUDE.md requires no external dependencies or components. The skill operates independently to validate formatting and place changes under appropriate sections directly within your project environment.

Why does my CLAUDE.md living document lose context between active work sessions?▼

Your CLAUDE.md loses context because corrections and preferences are not updated immediately. The skill solves this by applying instant updates whenever new patterns or gotchas are discovered during active work.