Text Optimizer

MIT License

Copyright (c) 2025-2026 Maxim Kochetkov (kochetkov-ma)
https://github.com/kochetkov-ma/claude-brewcode

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Text Optimizer

Optimize prompts, CLAUDE.md, agent instructions, and documentation for LLM token efficiency. Applies 41 research-backed rules across 6 categories. Typical savings: **30-50%** on prose, **20-30%** on technical specs.

## Quick Start

1. Install:
   ```bash
   npx skills add kochetkov-ma/claude-brewcode
   ```

2. Use via slash command:
   ```
   /text-optimizer my-prompt.md
   /text-optimizer my-prompt.md -d      # deep — max compression
   /text-optimizer my-prompt.md -l      # light — cleanup only
   /text-optimizer .claude/agents/      # directory — all .md files in parallel
   ```

   Or via natural language prompt:
   ```
   Optimize my-prompt.md for token efficiency
   Optimize all agent instructions in .claude/agents/
   ```

Claude reads 41 rules, analyzes your files, applies transformations, and outputs a before/after report with token counts. For directories — finds all `.md` files and processes them in parallel.

## Why Use This

- **Token savings** — 30-50% fewer tokens in system prompts means lower cost and more room for context
- **Better compliance** — rules based on how Claude 4.x actually processes instructions, not intuition
- **Research-backed** — every rule cites a source (Anthropic docs, arXiv papers, TACL 2024)
- **Non-destructive** — preserves all facts, logic, and cross-references; only changes form
- **Three modes** — light cleanup for stable docs, deep compression for cost-critical prompts

## Examples

### Single file — default medium mode

```
/text-optimizer CLAUDE.md
```

Applies all 41 rules with balanced restructuring. Best for most files.

<details>
<summary>Optimization: filler removal + positive framing</summary>

Before:
```markdown
Please note that it's important to remember that the API basically
requires authentication for all endpoints. Do not use markdown
formatting in your responses. You should never create new files
when fixing bugs.
```

After:
```markdown
The API requires authentication for all endpoints. Write responses
in flowing prose without formatting. Apply all bug fixes to
existing files only.
```

Rules: filler removed (T.6), negative "do not" flipped to positive "do Y" (C.3), "you should" dropped for imperative (S.2).

</details>

<details>
<summary>Optimization: prose to table</summary>

Before:
```markdown
The function accepts three parameters: name (string, required),
age (number, optional, defaults to 0), and active (boolean,
optional, defaults to true).
```

After:
```markdown
| Param  | Type    | Required | Default |
|--------|---------|----------|---------|
| name   | string  | yes      | —       |
| age    | number  | no       | 0       |
| active | boolean | no       | true    |
```

Rule: tables over prose for multi-column data (T.1).

</details>

### Deep mode — max compression

```
/text-optimizer system-prompt.md -d
```

Ag