Agent skill
instruction-optimizer
Use when instruction files (skills, prompts, CLAUDE.md) are too long or need token reduction while preserving capability. Triggers: "optimize instructions", "reduce tokens", "compress skill", "make this shorter", "too verbose".
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/instruction-optimizer
SKILL.md
Instruction Optimizer
Invariant Principles
- Smarter AND smaller - Compression that loses capability is regression, not optimization
- Evidence over claims - Show token counts before/after; verify no capability loss
- Unique value preservation - Deduplicate redundancy, keep distinct behaviors
- Clarity at critical points - Brevity yields to clarity for safety/compliance sections
Reasoning Schema
Inputs
| Input | Required | Description |
|---|---|---|
instruction_file |
Yes | Path to skill, prompt, or CLAUDE.md to optimize |
target_reduction |
No | Desired token reduction percentage (default: maximize) |
preserve_sections |
No | Sections to skip optimization (safety, legal) |
Outputs
| Output | Type | Description |
|---|---|---|
optimization_report |
Inline | Summary with before/after token counts |
optimized_content |
Inline | Full optimized file content |
verification_checklist |
Inline | Capability preservation verification |
Declarative Principles
| Principle | Application |
|---|---|
| Semantic deduplication | Same meaning stated N times -> state once |
| Example consolidation | Multiple examples of same pattern -> one with variants noted |
| Verbose phrase elimination | "In order to" -> "To"; "It is important to note that" -> [delete] |
| Section collapse | Overlapping sections -> merge under single heading |
| Implicit context removal | Obvious-from-title content -> delete |
| Conditional flattening | Nested if-chains -> single compound condition |
Compression Patterns
"In order to" -> "To"
"Make sure to" -> [delete]
"You should always" -> "Always"
"Prior to doing X" -> "Before X"
"In the event that" -> "If"
"Due to the fact that" -> "Because"
"At this point in time" -> "Now"
"For the purpose of" -> "To"
Process
- Read file completely
- Estimate tokens (words * 1.3)
- Identify safety-critical sections (skip these)
- Apply compression patterns
- Draft optimized version
- Verify capability preservation
- Calculate savings, present diff
Output Format
## Optimization Report: [filename]
### Summary
- Before: ~X tokens | After: ~Y tokens | Savings: Z (N%)
### Changes
1. [Technique]: [Description] (-N tokens)
### Verification
- [ ] Triggers preserved
- [ ] Edge cases handled
- [ ] Outputs specified
- [ ] Clarity maintained
### Optimized Content
[full content]
Skip Optimization When
- Already minimal (<500 tokens)
- Safety-critical content
- Legal/compliance requirements
- Recently written (let stabilize)
Self-Check
Before completing:
- Token count reduced (show numbers)
- All triggers from original still work
- All edge cases still handled
- No safety sections compressed
- Terminology consistent throughout
- Structured formats preserved exactly
If ANY unchecked: STOP and fix before presenting result.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?