RTK Optimizer Skill

RTK Optimizer Skill

**Purpose**: Automatically suggest RTK wrappers for high-verbosity commands to reduce token consumption.

How It Works

• **Detect high-verbosity commands** in user requests
• **Suggest RTK wrapper** if applicable
• **Execute with RTK** when user confirms
• **Track savings** over session

Supported Commands

Git (>70% reduction)

• `git log` → `rtk git log` (92.3% reduction)
• `git status` → `rtk git status` (76.0% reduction)
• `find` → `rtk find` (76.3% reduction)

Medium-Value (50-70% reduction)

• `git diff` → `rtk git diff` (55.9% reduction)
• `cat <large-file>` → `rtk read <file>` (62.5% reduction)

JS/TS Stack (70-90% reduction)

• `pnpm list` → `rtk pnpm list` (82% reduction)
• `pnpm test` / `vitest run` → `rtk vitest run` (90% reduction)

Rust Toolchain (80-90% reduction)

• `cargo test` → `rtk cargo test` (90% reduction)
• `cargo build` → `rtk cargo build` (80% reduction)
• `cargo clippy` → `rtk cargo clippy` (80% reduction)

Python & Go (90% reduction)

• `pytest` → `rtk python pytest` (90% reduction)
• `go test` → `rtk go test` (90% reduction)

GitHub CLI (79-87% reduction)

• `gh pr view` → `rtk gh pr view` (87% reduction)
• `gh pr checks` → `rtk gh pr checks` (79% reduction)

File Operations

• `ls` → `rtk ls` (condensed output)
• `grep` → `rtk grep` (filtered output)

Activation Examples

**User**: "Show me the git history" **Skill**: Detects `git log` → Suggests `rtk git log` → Explains 92.3% token savings

**User**: "Find all markdown files" **Skill**: Detects `find` → Suggests `rtk find "*.md" .` → Explains 76.3% savings

Installation Check

Before first use, verify RTK is installed:

rtk --version  # Should output: rtk 0.16.0+

If not installed:

# Homebrew (macOS/Linux)
brew install rtk-ai/tap/rtk

# Cargo (all platforms)
cargo install rtk

Usage Pattern

# When user requests high-verbosity command:

1. Acknowledge request
2. Suggest RTK optimization:
   "I'll use `rtk git log` to reduce token usage by ~92%"
3. Execute RTK command
4. Track savings (optional):
   "Saved ~13K tokens (baseline: 14K, RTK: 1K)"

Session Tracking

Optional: Track cumulative savings across session:

# At session end
rtk gain  # Shows total token savings for session (SQLite-backed)

Edge Cases

• **Small outputs** (<100 chars): Skip RTK (overhead not worth it)
• **Already using Claude tools**: Grep/Read tools are already optimized
• **Multiple commands**: Batch with RTK wrapper once, not per command

Configuration

Enable via CLAUDE.md:

## Token Optimization

Use RTK (Rust Token Killer) for high-verbosity commands:
- git operations (log, status, diff)
- package managers (pnpm, npm)
- build tools (cargo, go)
- test frameworks (vitest, pytest)
- file finding and reading

Metrics (Verified)

Based on real-world testing:

• `git log`: 13,994 chars → 1,076 chars (92.3% reduction)
• `git status`: 100 chars → 24 chars (76.0% reduction)
• `find`: 780 chars → 185 chars (76.3% reduction)
• `git diff`: 15,815 chars → 6,982 chars (55.9% reduction)
• `read file`: 163,587 chars → 61,339 chars (62.5% reduction)

**Average: 72.6% token reduction**

Limitations

• 446 stars on GitHub, actively maintained (30 releases in 23 days)
• Not suitable for interactive commands
• Rapid development cadence (check for breaking changes)

Recommendation

**Use RTK for**: git workflows, file operations, test frameworks, build tools, package managers **Skip RTK for**: small outputs, quick exploration, interactive commands

References

• RTK GitHub: https://github.com/rtk-ai/rtk
• RTK Website: https://www.rtk-ai.app/
• Evaluation: `docs/resource-evaluations/rtk-evaluation.md`
• CLAUDE.md template: `examples/claude-md/rtk-optimized.md`