Tuzi Update Claude Md

Keeps your CLAUDE.md file lean by enforcing a two-tier documentation strategy: core rules stay in CLAUDE.md as one or two sentence summaries (hard limit at 300 lines), while detailed examples and edge cases go into docs/CODING_RULES.md. You trigger it when you catch yourself repeating the same code review feedback or notice Claude making the same mistake again. It checks your recent git history, assesses whether the issue is worth documenting, and updates the right file with proper examples. The workflow includes duplicate checking and will warn you when CLAUDE.md is getting bloated. Supports custom preferences through EXTEND.md for things like line limits and commit message formats.

skills.sh installs: 150
GitHub stars: 39
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add tuziapi/tuzi-skills --skill tuzi-update-claude-md --agent claude-code

Installs into .claude/skills of the current project.

Files

Update CLAUDE.md

Analyzes code review feedback or development issues, extracts general rules, and updates documentation with a layered strategy (summary in CLAUDE.md, details in docs/CODING_RULES.md).

Core Principle

CLAUDE.md must stay concise. Summary rules only, 1-2 sentences each.

Document	Content	Line Limit
`CLAUDE.md`	Core summary rules (1-2 sentences)	≤ 300 lines
`docs/CODING_RULES.md`	Detailed rules + error/correct examples	No limit
`docs/FEATURE_FLOWS.md`	Feature flow documentation	No limit

Parameters

$ARGUMENTS: Description of the discovered issue or rule (optional)

Preferences (EXTEND.md)

Use Bash to check EXTEND.md existence (priority order):

# Check project-level first
test -f .tuzi-skills/tuzi-update-claude-md/EXTEND.md && echo "project"

# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
test -f "$HOME/.tuzi-skills/tuzi-update-claude-md/EXTEND.md" && echo "user"

SKILL.md on GitHub

Details

Repository: github.com/tuziapi/tuzi-skills
First seen: Jun 3, 2026