optimize-rules

Consolidate multiple Claude Code .md rule files into one optimized file.

Updated Aug 27, 2026

Search Tags:#audit #claude #backup #optimize #revert #rules #dry-run

Ready to run

npx skills add https://github.com/agentic-cookbook/tools --skill optimize-rules-agentic-cookbook

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: optimize-rules
Source: https://github.com/agentic-cookbook/tools/tree/main/skills/optimize-rules
Command: npx skills add https://github.com/agentic-cookbook/tools --skill optimize-rules-agentic-cookbook

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Claude Code rules are often split across many markdown files, which increases the per‑turn token usage and makes rule management cumbersome.

Core Features & Use Cases

Comprehensive audit of all rule files, extracting constraints and detecting duplicates.
Optimization proposal that outlines how rules will be merged and the expected reduction.
Safe execution with automatic backups, dry‑run mode, and a revert workflow to restore original files.
Validation ensuring every original constraint is preserved in the optimized output.

Quick Start

Run the Optimize Rules skill on your rule directory to create a single consolidated file while preserving all constraints.

Frequently Asked Questions about optimize-rules

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

FAQPage Schema

How do I consolidate multiple Claude Code rule files to reduce token usage?▼

To consolidate Claude Code rules, use an optimization process that merges multiple markdown files into a single file. This reduces per-turn context cost while preserving all original constraints through a validation checklist.

What is the best way to audit markdown rules for duplicates before merging?▼

Auditing markdown rules involves scanning a directory of .md files to extract constraints and detect duplicate instructions. This identifies redundant rules and outlines an optimization proposal for expected context reduction before merging.

Can I dry-run a rules optimization and revert changes if constraints are lost?▼

Yes, you can execute a dry-run to preview a rules optimization safely. The process automatically creates backups before merging markdown files and provides a revert workflow to restore original files if validation fails.

Does consolidating rule files require specific file-system tools?▼

Consolidating rule files requires standard file-system tools for reading, globbing directories of .md files, and writing the optimized output. These tools enable the extraction, merging, and backup of markdown constraints.

Why does splitting Claude Code rules across many files increase context cost?▼

Splitting Claude Code rules across many markdown files increases context cost because each file adds overhead to the per-turn token usage. Consolidating them into one optimized file reduces this cumulative context burden.