Promptles
Multi-Step

Make the Skill Stepwise

Split the skill into ordered phases; finish one before starting the next.

Multi-phase work — diagnose, then fix, then add a regression test — fails when the skill tries to do all of it in one pass. Break the body into ordered phases and tell the skill to complete one before moving on, ideally pausing for confirmation between risky steps. The agent gets a chance to verify each step, the user gets natural checkpoints, and a failure midway leaves the work in a recoverable state instead of a half-applied tangle.

Where you'll practice this

2 Promptles scenarios teach this principle directly. Each one drops you into a real engineering ticket and asks you to write the prompt you'd send to Claude Code.

  • The Diagnose Skill

    Your team has been bitten by 'just-fix-it' patches that solve symptoms without understanding root causes. You want a `diagnose` skill the agent runs when the user reports a bug. The skill should walk through five ordered phases — reproduce the failure, minimize the input, form a…

  • The TDD Skill

    You're authoring a `tdd` skill that walks the agent through one red-green-refactor cycle at a time. The current draft tries to do every cycle in a single response: it lists the feature, writes all the tests, makes them pass, refactors, and reports — and the result is…

Other principles in Multi-Step