standr/refactor

Code craft

AI-generated code works. It still tends to leave the small signals that nobody cared about: unclear names, uneven structure, repeated guards, and comments that explain mechanics instead of intent. The refactor skill removes each one.

10 skills

Diagnostic

/refactor-scan

Diagnose craft problems and recommend which skills to apply.

/refactor-review

Pre-merge craft gate: Ready / Mostly ready / Not ready verdict by dimension.

Clarity

/refactor-distill

Remove noise and reduce accidental complexity.

/refactor-rename

Fix weak or misleading names.

/refactor-explicit

Improve clarity even at the cost of slight verbosity.

/refactor-comment

Rewrite comments to explain reasoning, not obvious mechanics.

/refactor-decomment

Delete useless comments.

Consistency

/refactor-normalize

Unify style across related code.

/refactor-idiomatize

Make code feel natural for the language and framework.

/refactor-symmetry

Align parallel functions, classes, and modules.

Demo

The diff

Same billing backend, same logic. The left side is what AI generates under time pressure. The right side is what a careful senior engineer would ship.

Use on formulas, domain-specific logic, and any place where you know more than the code says. It adds a comment where correctness is non-obvious: integer division chosen to avoid partial cents, a pro-rata rule from a contract, a guard that exists because of a specific past incident. It adds the minimum explanation that prevents the next reader from undoing a deliberate choice.

The formula is correct — but without context, every reader will wonder why it floors, why 360, and why the +1.
def calculate_proration(
    annual_amount: int,
    start_day: int,
    end_day: int,
) -> int:
    days = end_day - start_day + 1
    return annual_amount * days // 360
def calculate_proration(
    annual_amount: int,
    start_day: int,
    end_day: int,
) -> int:
    # 360-day commercial year per EU contract
    # standard. +1: both start and end days are
    # billable. Floor division: no partial cents.
    days = end_day - start_day + 1
    return annual_amount * days // 360

Install

$ npx skills add https://gitlab.com/standr.dev/standr