skills.rest
shawn-sandy
shawn-sandyCOMMUNITY
Explore all skills by this author →
Website𝕏@shawnsandyGitHub

md-optimizer

Audit and optimize CLAUDE.md files for Claude Code best practices.

2|Updated Jan 19, 2026
Search Tags:#code quality#documentation#prompt engineering#optimization#auditing#claude.md
One-click install
npx skills add https://github.com/shawn-sandy/agentics --skill md-optimizer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: md-optimizer
Source: https://github.com/shawn-sandy/agentics/tree/main/plugins/claude-md-optimizer/skills/claude-md-optimizer
Command: npx skills add https://github.com/shawn-sandy/agentics --skill md-optimizer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses issues where CLAUDE.md files become bloated, inconsistent, or ignore instructions, ensuring they remain effective and performant.

Core Features & Use Cases

  • Audits CLAUDE.md: Analyzes files against best practices for instruction budget, section quality, and progressive disclosure.
  • Identifies Issues: Detects sensitive data, rule violations, and structural problems.
  • Optimizes Content: Offers to generate a cleaner, more efficient version of the CLAUDE.md file.
  • Use Case: If Claude is consistently ignoring instructions in your project's CLAUDE.md, this skill can audit the file, identify the cause (e.g., too many instructions, poor structure), and suggest or apply optimizations.

Quick Start

Use the md-optimizer skill to audit the CLAUDE.md file in the current directory.

Frequently Asked Questions about md-optimizer

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

FAQPage Schema
Why does Claude ignore instructions in my CLAUDE.md file?▼

Claude ignores CLAUDE.md instructions when the file is bloated or poorly structured. Auditing the file helps identify issues like excessive instruction counts, poor section quality, or structural problems that degrade performance.

How do I optimize a CLAUDE.md file for better performance?▼

To optimize a CLAUDE.md file, audit its instruction budget, section quality, and progressive disclosure. This process detects rule violations and sensitive data, offering a cleaner, more efficient version that adheres to Claude Code best practices.

What is progressive disclosure in Claude Code documentation?▼

Progressive disclosure in Claude Code documentation is a structural practice that manages the instruction budget by organizing section quality. Auditing your CLAUDE.md ensures this structure is maintained for optimal clarity and performance.

How do I check my CLAUDE.md file for sensitive data?▼

You can check your CLAUDE.md file for sensitive data by running an audit. This process analyzes the file against safety best practices to identify sensitive information and rule violations, suggesting externalizing content if needed.

Can I use an auditing tool to fix CLAUDE.md structure violations?▼

Yes, an auditing tool can fix CLAUDE.md structure violations by analyzing the file against best practices. It identifies structural problems and generates an optimized version that corrects rule violations and improves efficiency.

Related Skills

Explore More Software Engineering Skills→
AndurilCodeAndurilCode
7

rule-quality-evaluator

Score agent instruction rules against seven properties and structural diagnostics.

Official
Advanced
epicrunzeepicrunze
8

jarvis-toggle

Toggle JaRVIS on or off by patching platform instruction files with backups.

Community
Intermediate
tianjianjiangtianjianjiang
1

smith-prompts

Define and enforce prompt engineering standards for AGENTS.md and caching workflows.

Community
Advanced
Mahaboob26Mahaboob26

markdown-documentation

Create structured Markdown documentation with GitHub Flavored Markdown formatting.

Community
Basic