Turbo Improve

create the plans, run the agents, ship the fixes

---

Run it

run turbo-improve in this repo

What it does

1. Creates one goal for the whole run.
2. Uses improve to read the repo, find improvement opportunities, and write execution-ready plans.
3. Uses make-interfaces-feel-better to add UI/interface polish plans when the repo has a frontend.
4. Uses ponytail to keep plans and implementation simple, readable, and low-bloat.
5. Implements the plans, including existing open plans, with parallel agents when possible.
6. Reviews diffs, runs checks, updates plan status, and stops only when every plan is done or deliberately retired.

Examples

Full loop:

run turbo-improve in this repo

Plan only:

run turbo-improve in this repo, but only create plans; do not implement yet

Implement existing plans:

run turbo-improve in this repo and implement the plans that already exist

Fast install

Ask your agent to install it:

install this skill https://github.com/Fakamoto/turbo-improve

Installation

Agent Skills-compatible tools:

npx skills add Fakamoto/turbo-improve

Codex local skill install from a cloned checkout:

git clone https://github.com/Fakamoto/turbo-improve.git
cd turbo-improve
mkdir -p "$HOME/.codex/skills"
ln -s "$PWD/skills/turbo-improve" "$HOME/.codex/skills/turbo-improve"

Codex plugin metadata is included at .codex-plugin/plugin.json for setups that package skills through Codex plugin marketplaces.

Compatibility

Agent/tool	Status
Codex	Native skill folder and optional Codex plugin metadata
Agent Skills tools	skills/turbo-improve/SKILL.md layout
Claude Code	Usable as an agent skill if your setup supports Agent Skills
Other agents	Copy the skill folder or ask the agent to install the repo

This repo intentionally ships no hooks. It is just instructions, so it stays portable.

Repo layout

skills/turbo-improve/SKILL.md       # the skill
skills/turbo-improve/agents/        # UI metadata
.codex-plugin/plugin.json           # optional Codex plugin metadata
assets/turbo-improve.png            # README/plugin visual