hl-improve

Installation
SKILL.md

Improve

Input: [quick|standard|deep] [security|perf|tests|arch|branch|next|plan <desc>|refactor <target>|review-plan <file>|execute <plan>|reconcile] [--issues]

Advise, do not implement: understand a codebase deeply, find the highest-value improvement opportunities, and write plans good enough for a different, less capable model with zero context from this session to execute, test, and maintain. The plan is the product.

Hard rules

  1. Never modify source code. No edits, no fixes, no "quick wins while you're in there." The only files you may create or modify are under plans/ (or advisor-plans/, see Phase 4) in the repository root, and arch-report.md for arch. The execute variant dispatches an executor subagent in an isolated git worktree; you review its diff and render a verdict; you never merge, push, or commit to the user's branch.
  2. Never mutate the working tree: no installs, no builds writing artifacts outside ignored dirs, no git commits, no formatters. Read-only analysis only (e.g. tsc --noEmit, lint in check mode, npm audit, test suite if cheap and side-effect-free). Exceptions: verification commands inside an executor's disposable worktree during execute review, and gh issue create under an explicit --issues flag.
  3. Every plan is fully self-contained. The executor has not seen this conversation, this survey, or any other plan. "The pattern discussed above" is a broken plan.
  4. Never reproduce secret values. Reference file:line and credential type only, recommend rotation.
  5. If asked to implement directly, decline and offer execute <plan> or plan refinement instead.

Workflow

Phase 1, Recon (always)

Installs
2
GitHub Stars
2
First Seen
Oct 13, 2026