All products

Write learner instructions with AI

Turn dense course directions into clear English steps, each with an observable result and a practical recovery instruction where it is needed.

Write learner instructions with AI for the person who cannot tell whether the last click worked. An instruction to open a project is incomplete if three similar windows might appear. The plain-instructions skill asks for an observable result after each step and a recovery action where failure is plausible.

Try the original procedure before rewriting it. Note the exact window title, file or prompt that signals success. Move background reasoning away from the actions so a learner can keep their place while switching between the guide and the application.

What it does

  • Split a sentence that asks the participant to do two things.
  • Give each numbered action a recognisable success signal.
  • Put a likely fix beside the step where it is needed.
  • Move explanations into a short separate callout.
  • Review wording flagged by the local checker in its original context.

Install and use

  1. Supply the authorised English handout and the actual expected results. The optional checker needs a compatible shell and standard text tools.
  2. Ask, “Rewrite these project-opening steps for a first-time participant. Tell them what they should see and what to try if that does not appear.”
  3. Walk through the result as a learner and correct any instruction whose expected result does not match the screen.

FAQ

Source

Made by drarunmitra. Original skill: plain-instructions, published on GitHub under the CC-BY-4.0 licence. The files are unchanged.

View on GitHub