Update Docs Skill

Update README.md files in the folders where code was changed. Documentation lives next to the code it describes — each component/abstraction folder has its own README.

When to Use

Activate this skill when:

The user explicitly asks to update documentation after changes
After completing a task that adds, removes, or significantly modifies files in a component/abstraction folder

Principles

Co-located — Each README lives in the folder it documents
Lean — Only document what helps a developer understand the folder's purpose, structure, and patterns
Precise — Accurate file names, sizes, type counts, and descriptions
Compact — No verbose prose. Use tables, bullet points, and code snippets
Delta-driven — Only update sections affected by the change. Don't rewrite unrelated content

README Structure Convention

Update Docs Skill

Update README.md files in the folders where code was changed. Documentation lives next to the code it describes — each component/abstraction folder has its own README.

When to Use

Activate this skill when:

The user explicitly asks to update documentation after changes
After completing a task that adds, removes, or significantly modifies files in a component/abstraction folder

Principles

Co-located — Each README lives in the folder it documents
Lean — Only document what helps a developer understand the folder's purpose, structure, and patterns
Precise — Accurate file names, sizes, type counts, and descriptions
Compact — No verbose prose. Use tables, bullet points, and code snippets
Delta-driven — Only update sections affected by the change. Don't rewrite unrelated content

Change Type	Documentation Action
New file added	Add entry to the file list with one-line description
File removed	Remove entry from the file list
File renamed	Update the entry
New pattern introduced	Add/update the Pattern section
Architecture change	Update the Architecture section
File count changed	Update the count in the overview line
New block/menu/popup type	Add to the relevant type list

Update Docs

Update Docs Skill

When to Use

Principles

README Structure Convention

Update Docs

Update Docs Skill

When to Use

Principles

README Structure Convention

What to Document

What NOT to Document

Process

Scope Rules

Examples

File added to block/

New store added

File removed from menu/

New subfolder created

My Workflow

Create Instructions

Init

Everything Claude Code Conventions

Codebase Onboarding

Ui Demo