improve

Audits codebases and writes self-contained implementation plans for other agents to execute.

2|2|Updated Dec 23, 2017
One-click install
npx skills add https://github.com/xriu/dotfiles --skill improve-xriu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve
Source: https://github.com/xriu/dotfiles/tree/main/home/.skills/improve
Command: npx skills add https://github.com/xriu/dotfiles --skill improve-xriu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Codebase audits often produce vague advice that dies in a chat transcript. This Skill surveys a repository like a senior advisor, vets every finding against the actual code, and produces prioritized, fully self-contained implementation plans that a separate, less capable model or agent can execute without any context from the original session. ## Core Features & Use Cases - Read-only codebase audit: Surveys correctness, security, performance, test coverage, tech debt, dependencies, DX, docs, and product direction using parallel read-only subagents, with strict rules against modifying source code. - Self-contained handoff plans: Writes plans to .scratch/plans/ with inlined code excerpts, exact verification commands, scope boundaries, STOP conditions, and machine-checkable done criteria so an executor with zero context can succeed. - Execution and follow-through: Supports invocation variants like quick/deep effort levels, branch diffs, next roadmap audits, execute <plan> with an isolated-worktree executor and tech-lead review, reconcile for stale plans, and --issues to publish plans as GitHub issues. - Use Case: Point it at a legacy service and ask for a security audit; it returns a vetted findings table, then writes ordered plans (e.g., add characterization tests before refactoring) that a cheaper executor agent implements in a worktree while it reviews the diff. ## Quick Start Ask the agent to audit this repository for improvement opportunities and write prioritized implementation plans for the top findings.

Frequently Asked Questions about improve

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a codebase and generate implementation plans for another AI agent?▼

Invoke the skill on a repository and it runs recon, audits across nine categories with parallel read-only subagents, vets findings against the actual code, then writes self-contained plans to .scratch/plans/. Each plan includes code excerpts, verification commands, and done criteria so a zero-context executor can implement it.

What does the improve skill check during a code audit?▼

It audits nine categories: correctness and bugs, security, performance, test coverage, tech debt and architecture, dependencies and migrations, developer experience and tooling, docs, and product direction. Every finding requires file:line evidence, impact, effort, risk, and confidence ratings.

Can the skill modify or fix my source code directly?▼

No. It is strictly read-only on source code and only writes plan files under .scratch/plans/. For implementation, the execute variant dispatches a separate executor subagent in an isolated git worktree, then reviews the diff without ever merging or committing to your branch.

How do I control the depth of the codebase audit?▼

Add quick or deep anywhere in the invocation to set the effort level; standard is the default. Quick covers hotspots with top findings only, while deep audits the whole repo with up to eight subagents including low-confidence investigate items.

Can audit findings be published as GitHub issues?▼

Yes, but only with the explicit --issues flag on a planning invocation. It verifies gh authentication, creates one issue per plan with the plan file as the body, and records each issue URL in the plan and the index.

What happens when a plan becomes stale after code changes?▼

Each plan stamps the commit it was written against and includes a drift check comparing in-scope files. The reconcile variant re-verifies done plans, refreshes drifted excerpts and SHAs, and retires findings that were fixed independently.