GitHub - klh/speedy-claude: Make Claude Code 10-1400x faster at file operations. Modern CLI tools + CLAUDE.md rules that replace sequential Read+Edit with single parallel pipelines.

Based on agent-skills — production-grade engineering skills for AI coding agents, extended with CLI speed optimizations that make file operations 10-1400x faster.

Companion repo: klh/skills — personal agent skills published at npx skills add klh/skills.

  DEFINE          PLAN           BUILD          VERIFY         REVIEW          SHIP
 ┌──────┐      ┌──────┐      ┌──────┐      ┌──────┐      ┌──────┐      ┌──────┐
 │ Idea │ ───▶ │ Spec │ ───▶ │ Code │ ───▶ │ Test │ ───▶ │  QA  │ ───▶ │  Go  │
 │Refine│      │  PRD │      │ Impl │      │Debug │      │ Gate │      │ Live │
 └──────┘      └──────┘      └──────┘      └──────┘      └──────┘      └──────┘
  /spec          /plan          /build        /test         /review       /ship

Plus CLI speed tools that replace slow sequential file operations with single parallel pipelines.

The Problem

Claude Code edits files one at a time. Each Read or Edit tool call costs ~0.5-1s of round-trip overhead. When a change affects 50 files, that's ~50 seconds of just waiting — before Claude even thinks.

The fix: single CLI commands that do the same work in milliseconds.

Benchmarks

Tested on a real codebase (733 TypeScript files, ~2500 total files, Apple M-series, 10 cores):

Install

Option 1: Clone into ~/.claude (recommended — like dotfiles)

# Back up existing config if needed
mv ~/.claude ~/.claude.bak

# Clone directly — skills/ and CLAUDE.md land in the right place
git clone https://github.com/klh/speedy-claude.git ~/.claude

# Install CLI tools
~/.claude/install.sh

Option 2: CLI tools only (no skills)

curl -fsSL https://raw.githubusercontent.com/klh/speedy-claude/main/install.sh | bash

Option 3: Install via npx skills

# Install all skills from this repo
npx skills add klh/speedy-claude -g -y

# Or install the companion personal skills repo
npx skills add klh/skills -g -y

What the install script does

1. Installs 30+ tools via Homebrew and Cargo
2. Sets delta as your git diff pager
3. Initializes zoxide for smart cd
4. Prints a summary of what changed

Skills and CLAUDE.md are included by cloning the repo into ~/.claude/ — no copying needed.

All 39 Skills

Define — Clarify what to build

Plan — Break it down

Build — Write the code

Verify — Prove it works

Review — Quality gates before merge

Ship — Deploy with confidence

Configure & Docs

Meta

Slash Commands

7 commands that map to the development lifecycle:

Agent Personas

Pre-configured specialist personas for targeted reviews:

How CLI Speed Tools Work

The cli-speed-tools skill teaches agents to:

1. Never Read+Edit in a loop — use ambr/sd/sad pipelines for multi-file changes
2. Search with context — use batgrep instead of rg + separate Read calls
3. Use structural diffs — use difft instead of raw git diff
4. Run linters first — use shellcheck/actionlint before manual review
5. Use parallel execution — fd -x and ambr run in parallel by default
6. Use single-command patterns — rg -c | awk replaces Grep+Read+count

Project Structure

speedy-claude/
├── skills/                    # 39 skills (SKILL.md per directory)
├── agents/                    # 3 specialist personas
├── hooks/                     # Session lifecycle hooks
├── .claude/commands/          # 7 slash commands
├── references/                # 4 supplementary checklists
├── docs/                      # Setup guides per tool
├── install.sh                 # CLI speed tools installer
├── CLAUDE.md                  # Project config
└── AGENTS.md                  # Agent conventions

Credits

• agent-skills by Addy Osmani — 20 production-grade engineering skills
• klh/skills — 13 personal agent skills, published via npx skills add klh/skills
• Custom skills and CLI speed tools by Klaus L. Hougesen

License

MIT