skills.rest
anyproto
anyprotoOFFICIAL
Explore all skills by this author →
Website𝕏@AnytypeLabsGitHub

claudemd-maintainer

Reviews and optimizes CLAUDE.md files for effective LLM instruction structure.

514|79|Updated May 26, 2023
Search Tags:#audit#ai assistant#Optimization#Documentation#LLM instructions#Progressive Disclosure#clauDE.md
One-click install
npx skills add https://github.com/anyproto/anytype-swift --skill claudemd-maintainer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claudemd-maintainer
Source: https://github.com/anyproto/anytype-swift/tree/main/.claude/skills/claudemd-maintainer
Command: npx skills add https://github.com/anyproto/anytype-swift --skill claudemd-maintainer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CLAUDE.md files tend to accumulate duplicate rules, outdated code snippets, and narrow-scope guidance that degrade LLM instruction-following performance. This Skill provides audit checklists, consolidation workflows, and research-backed limits to keep project instruction files concise and effective.

Core Features & Use Cases

  • Audit Checklist: Verifies line count under 300, detects duplicate rules, and flags outdated embedded code snippets.
  • Optimization Workflow: Guides consolidation of critical rules, replacement of code blocks with file path references, and migration of narrow guidance into skills.
  • Progressive Disclosure Pattern: Structures documentation across three levels (CLAUDE.md, skills, specialized guides) to reduce context overhead.
  • Use Case: When a project's CLAUDE.md grows past 300 lines with repeated rules, use this Skill to find duplicates, consolidate critical rules into one section, and move task-specific content into dedicated skills.

Quick Start

Review my CLAUDE.md file and suggest how to reduce it below 300 lines while removing duplicate rules.

Frequently Asked Questions about claudemd-maintainer

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

FAQPage Schema
How do I reduce the size of my CLAUDE.md file?▼

Find duplicate rules with grep, consolidate critical rules into a single section, replace embedded code snippets with file path references, and move task-specific guidance into skills. Target 100-150 lines with a hard maximum of 300.

What should a CLAUDE.md file include?▼

Include technology stack overview, consolidated critical rules, essential quick-start commands, file path references to detailed guides, and documented common mistakes. Exclude code style rules handled by linters, exhaustive command references, and task-specific instructions.

How many instructions can an LLM handle reliably?▼

Research cited in this Skill indicates LLMs handle roughly 150-200 instructions reliably, with performance degrading beyond that. This is why CLAUDE.md should stay under 300 lines and ideally between 100-150 lines.

Should I put code snippets in CLAUDE.md?▼

No. Embedded code snippets become outdated as the codebase evolves, creating a maintenance burden. Use file path references with line numbers instead, such as pointing to a typography mapping file rather than pasting Swift code examples.

When should guidance go in a skill instead of CLAUDE.md?▼

Move guidance to a skill when it applies to fewer than about 20 percent of tasks. CLAUDE.md should only contain universally applicable rules; narrow-scope or domain-specific instructions belong in skills or specialized documentation.

Related Skills

Explore More Software Engineering Skills→
bmad-code-orgbmad-code-org
52.5k

bmad-project-context

Creates and maintains verified AGENTS.md instruction blocks for AI coding agents in a repository.

Official
Advanced
videojsvideojs
931

maintain-agent-docs

Maintain AGENTS.md and CLAUDE.md guidance by removing duplication and enforcing context budgets.

Official
Intermediate
dolsoondolsoon

moai-cc-skills

Automates Claude Code skill creation, management, and metadata-driven organization.

Community
Basic
daisuke-tanabedaisuke-tanabe

sync-lint-docs

Remove ESLint and Prettier enforced code style rules from Markdown documentation.

Community
Intermediate