1. Habit
  2. Skills
  3. Improve skill
shadcn · 37K installs

Improve skill
Runs by itself, weekly code audit.

Fresh improvement plans every week.

Install the Improve skill and make it a habit: follow https://gethabit.dev/skills/shadcn/improve.md

  1. 1Copy
  2. 2Paste into Claude Code, Codex or Cursor
  3. 3It runs by itself

37K installs9K starsMIT licenceSource on GitHub ↗

Improve

by shadcn · 37K installs

The skill

The improve skill audits a codebase as a read-only senior advisor and writes ranked, self-contained plans for other agents to execute.

Only when you ask.

The habit

Fresh improvement plans every week.

↻ Runs by itselfweekly code audit

How the habit works.
You don't have to.

Three questionsWhen does it start? How does it check its work? What does it remember?

01

It starts by itself

weekly code audit. Runs in Claude Code routine.

  • ↻ weekly code audit
  • 0 8 * * 1

02

It checks its work

plans checked, you pick. If a check fails, it stops.

  • ✓no file outside plans/ was changed
  • ✓every finding cites file:line evidence
  • ✓every plan stamps the git rev-parse commit

03

It remembers

plans index. The next run reads it first: plan status, dependencies and rejected findings.

plans/README.md

One run, step by step.
Then it stops.

Stop ruleStops after the top 6 findings and at most 5 new plans per run.

  1. 01

    Reconcile

    Verify done plans, look into blocked ones and refresh drifted ones.

  2. 02

    Recon

    Read README, config, CI and design docs, and note build, test and lint commands.

  3. 03

    Audit

    Run a quick audit on correctness, security and tests with read-only subagents.

  4. 04

    Vet findings

    Open each cited file, drop by-design items and record rejections.

  5. 05

    Ask which to plan

    Show the ranked table and ask you which findings become plans.

  6. 06

    Write plans

    Write self-contained plans in plans/ and update plans/README.md.

What it may do.
Nothing more.

Safe by defaultIt writes only in its own folder and asks you before anything goes out.

Is it for you?
Use it when it fits.

Quick checkRead both lists. If the left one sounds like you, the Improve skill helps.

Use it when

  • ✓ You want an audit of a codebase
  • ✓ You need plans for another agent
  • ✓ You ask where to take the project next

Skip it when

  • – You want the code fixed right now
  • – The repo is a tiny script

Questions

Improve skill, answered.

Will it fix the code?

No. It only writes plans. The execute variant sends one plan to a separate executor and reviews the diff.

What if it finds a secret?

It cites the file and line and the credential type, never the value, and recommends rotation.

How do I install the Improve skill?

Copy the prompt at the top into your agent. It installs the skill from shadcn/improve and sets up the habit. Or run npx skills add shadcn/improve --skill improve.

Is the Improve skill free?

Yes. It is published under MIT. Habit is free too.

Improve. Now as a habit.

Install the Improve skill and make it a habit: follow https://gethabit.dev/skills/shadcn/improve.md

  • Free
  • No account
  • Undo in one line

All shadcn skills →More planning skills →

Works in

  • Claude Code
  • Codex
  • Cursor
  • ChatGPT
  • Claude app

Made by shadcn, published under MIT. Habit links to the original and never changes it. Is this your skill?

Copying didn't work here. Select the line and copy it by hand.