Rtk Optimizer

Name: Rtk Optimizer
Author: florianbruniaux

florianbruniaux/claude-code-ultimate-guide

193 installs
5.7k repo stars
Updated August 4, 2026
florianbruniaux/claude-code-ultimate-guide

Cut verbose git, test, and package-manager CLI output in agent sessions by routing commands through RTK wrappers so more context stays available for real work.

About

RTK Optimizer is an agent skill for solo and indie builders who burn context windows on noisy terminal output during Claude Code, Cursor, or similar workflows. When you ask the agent to run git history, diffs, test suites, or large file reads, the skill recognizes those patterns and recommends wrapping them with RTK so summaries replace wall-of-text stdout. That matters because long agent sessions—debugging a failing pytest run, scanning a cargo clippy report, or reviewing a PR with gh—otherwise eat tokens you need for patches and reasoning. The flow is lightweight: detect the command, propose the RTK variant, execute on confirm, optionally tally savings. It is not a test framework or Git replacement; it is a token-efficiency layer on commands you already run while building and shipping.

Detects high-verbosity commands (git log, diff, pytest, cargo test, vitest, gh pr view) and suggests RTK equivalents
Documents measured token reductions from ~55% (git diff) up to ~92% (git log) per supported command
Covers Git, JS/TS (pnpm/vitest), Rust (cargo), Python (pytest), Go (go test), and GitHub CLI
Runs only after user confirmation and can track savings across a session
Requires Bash; wraps output rather than changing underlying tool behavior

Rtk Optimizer by the numbers

193 all-time installs (skills.sh)
Ranked #2,909 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
Security screen: MEDIUM risk (skills.sh audit)
Data as of Aug 5, 2026 (Skillselion catalog sync)

npx skills add https://github.com/florianbruniaux/claude-code-ultimate-guide --skill rtk-optimizer

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/florianbruniaux/claude-code-ultimate-guide/rtk-optimizer.svg)](https://skillselion.com/skills/florianbruniaux/claude-code-ultimate-guide/rtk-optimizer)

Installs	193
repo stars	★ 5.7k
Security audit	2 / 3 scanners passed
Last updated	August 4, 2026
Repository	florianbruniaux/claude-code-ultimate-guide ↗

What it does

Cut verbose git, test, and package-manager CLI output in agent sessions by routing commands through RTK wrappers so more context stays available for real work.

Files

SKILL.mdMarkdownGitHub ↗

RTK Optimizer Skill

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

How It Works

1. Detect high-verbosity commands in user requests 2. Suggest RTK wrapper if applicable 3. Execute with RTK when user confirms 4. 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