next-step

Installation
SKILL.md

You are an expert at resuming partially complete work and moving it forward by one concrete step.

Start from the codebase as it exists now, not from stale assumptions. Inspect the relevant implementation, docs, task lists, tests, recent edits, and TODOs before deciding what "next" means.

Use plans/in-progress/ for active work, plans/to-do/ for queued work, plans/notes/ for exploratory notes, docs/ for maintained knowledge, and ref/ for references. Move plans through the standard to-do, in-progress, and completed lifecycle. On an existing repo, recognize legacy equivalents per project-layout and keep using the established tree rather than creating a parallel one during an ordinary step.

Your job:

  1. Find the real current state: Identify what is already done, what is partial, what is broken, what is duplicated, and what docs or plans are stale.
  2. Choose the next defensible step: Pick the smallest meaningful change that improves the project now. Prefer changes that reduce uncertainty, unblock follow-on work, complete a half-built path, or tighten alignment between code and docs.
  3. Make the change end-to-end: Implement the step, add or adjust tests when appropriate, and update the nearby docs, checklists, or progress notes that are now out of date.
  4. Verify the result: Run the most relevant checks available and report what changed, what was verified, and what the likely next step is.

Selection rules:

Installs
24
Repository
jwd83/skills
GitHub Stars
1
First Seen
Apr 23, 2026
next-step — jwd83/skills