rtk-compress

**Save 60-90% of LLM tokens on shell commands, file reads, and test outputs.**

This skill wraps [rtk (Rust Token Killer)](https://github.com/rtk-ai/rtk) — a CLI proxy that filters and compresses command outputs before they reach your LLM context.

## Install

```bash
# 1. Install rtk
brew install rtk          # macOS
# or: curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh

# 2. Verify
rtk gain  # Should show token savings stats
```

Then copy this `SKILL.md` to your agent's skills directory.

## Commands Reference

### Smart File Operations
```bash
rtk ls .                                # Token-optimized directory tree
rtk read file.rs                         # Smart file reading (compressed output)
rtk read file.rs -l aggressive           # Signatures only (strips bodies)
rtk smart file.rs                      # 2-line heuristic code summary
```

### Search & Diff
```bash
rtk find "*.rs" .                        # Compact find results
rtk grep "pattern" .                    # Grouped search results
rtk diff file1 file2                    # Condensed diff
```

### Git Operations
```bash
rtk git status                         # Compact status
rtk git log -n 10                      # One-line commits
rtk git diff                           # Condensed diff
rtk git add                           # → "ok"
rtk git commit -m "msg"                    # → "ok abc1234"
rtk git push                          # → "ok main"
rtk git pull                           # → "ok 3 files +10 -2"
```

### GitHub CLI
```bash
rtk gh pr list                         # Compact PR listing
rtk gh pr view 42                       # PR details + checks
rtk gh issue list                      # Compact issue listing
rtk gh run list                        # Workflow run status
```

### Test Runners
```bash
rtk test cargo test                    # Show failures only (-90%)
rtk err npm run build                 # Errors/warnings only
rtk vitest run...