Improve

Makes existing code easier to understand without changing behavior. Use to simplify structure, remove duplication or dead code, improve names, or remove unnecessary abstractions.

434 stars 73 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add owainlewis/blueprint --skill improve
Manual install
git clone --depth 1 https://github.com/owainlewis/blueprint.git /tmp/blueprint
mkdir -p ~/.claude/skills
cp -r /tmp/blueprint/skills/improve ~/.claude/skills/improve

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Improve

Make code easier to understand without changing what it does. Reduce the layers a reader must trace and the hidden state they must remember.

## Process

1. Identify the target from the request, current diff, or recently changed code.
2. Read the target, its tests, and relevant surrounding code. State the behavior that must not change.
3. If that behavior lacks tests, add focused coverage and run it against the unchanged code. Commit the passing test-only change before refactoring. If automated tests cannot exercise the behavior, explain why and give other evidence.
4. Find unnecessary complexity, duplication, dead code, weak names, awkward boundaries, and abstractions that cost more than they help. Ask of each important value: can a new reader say where it comes from and what can change it?
5. Delete first: remove dead code and redundant checks before you reshape what is left. Then make focused improvements by deduplicating, renaming, simplifying, extracting, or inlining.
6. Preserve public interfaces, data shapes, errors, and user-visible behavior unless the user explicitly asks to change them.
7. Run tests and checks that cover behavior the refactor can affect. Report what improved, what behavior was preserved, and the evidence.

## Return

State what became simpler, what behavior stayed the same, and which checks prove it. Name any behavior that remains unverified.

## Boundaries

- Do not add product scope or absorb unrelated cleanup.
Read the full skill on GitHub

Details

Skill name
improve
Path
skills/improve/SKILL.md
License
MIT
Repo updated
10 November 2026

FAQ

What does the Improve skill do?

Makes existing code easier to understand without changing behavior. Use to simplify structure, remove duplication or dead code, improve names, or remove unnecessary abstractions.

How do I install the Improve skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add owainlewis/blueprint --skill improve. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Improve popular?

It lives in owainlewis/blueprint, which has 434 GitHub stars and 73 forks.

Related skills

Architecture

434

owainlewis/blueprint

Writes root ARCHITECTURE.md from a fixed template: the intended system, a data flow diagram, the data model, and the rules every feature must follow. Use for a new system or a change to its boundaries, data, or deployment.

Software Development73

Architecture Review

434

owainlewis/blueprint

Reviews a technical proposal before any code is written: an architecture, spec, RFC, ADR, or design issue. Finds choices that would make it wrong, unsafe, or impossible to prove, and the open questions that block building it.

Software Development73

Codex Issue Coordinator

434

owainlewis/blueprint

Coordinates a large batch of GitHub issues through separate Codex worker threads, tested pull requests, review loops, and gated merges. Use when the user asks one Codex thread to manage several coding sessions or complete a parent issue, milestone, or issue batch.

Software Development73

Sanity Singletons

200

sanity-io/agent-toolkit

Configure singleton documents in a Sanity Studio using the document.singletons registry. Use when a developer wants a fixed-id document (settings, navigation, footer) edited in place, hidden from the default content list, with no "create new" or "duplicate" affordances — or when migrating a userland singleton implementation or a third-party singleton plugin (e.g. sanity-plugin-singleton-management) to the first-class API.

Software DevelopmentIn 1 list32

Tlgr

201

tlgrcli/tlgr

Read and act on a personal Telegram account from the terminal with the tlgr CLI (MTProto user account, not a bot). Use when the user wants to check unread Telegram chats, read or search message history, send, reply to, edit, forward or schedule messages, manage chats, groups, channels, contacts, folders, reactions, polls, media or stories, or receive Telegram events through a webhook. Every command answers in JSON with stable exit codes.

Software DevelopmentIn 2 lists

Codebase Documenter

473

ailabs-393/ai-labs-claude-skills

This skill should be used when writing documentation for codebases, including README files, architecture documentation, code comments, and API documentation. Use this skill when users request help documenting their code, creating getting-started guides, explaining project structure, or making codebases more accessible to new developers. The skill provides templates, best practices, and structured approaches for creating clear, beginner-friendly documentation.

Software Development117

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.