Design the help around the exercise's purpose

To turn a book exercise into an interactive skill, identify what the reader should learn or produce, then specify how the skill should respond to complete, incomplete, uncertain, and unsuitable answers. Preserve the decisions the reader needs to make. Add help where your exercise currently leaves them stuck.

A useful interaction does more than ask each worksheet question in a chat window. It notices what is missing, offers a relevant hint, and makes clear when the exercise is complete. It also gives the reader a way to pause without inventing an answer just to fill every box.

Start with one exercise. The worked example below turns a fictional project-boundary worksheet into a guided exchange, a branch table, and a completed answer. It is a design example, not a record of an AI test or a customer result.

Decide what the reader should still do themselves

An exercise can serve different purposes. It might help someone notice a pattern, practice a decision, or produce a working document. The kind of assistance you offer should fit that purpose.

If the exercise teaches readers to distinguish an observation from an assumption, immediately supplying all the classifications removes the practice. The skill could first ask the reader to classify a statement, then explain a disagreement using your criteria.

If the exercise exists to produce a usable checklist, more drafting help may be appropriate. Even then, the reader needs to check whether the facts and proposed actions fit their situation.

Write one sentence before changing the format: “At the end, the reader should be able to ___, and the skill may help by ___.” This sentence will help you reject attractive features that do not serve the exercise.

Keep the way readers work in view

Interactive support should accommodate an actual working preference. In a discussion about workbooks, u/fflarengo explained:

“Oh wait, you don't need to write. Even I, prefer typing.”

The commenter described reading on a laptop and editing exercise PDFs. The wider thread discusses mental-health workbooks; this excerpt supports only a preference for typing, not a health claim or evidence for AI exercises. Original comment.

A different kind of difficulty appears in a math-exercise discussion. u/mnevmoyommetro described moving on after getting stuck:

“I leave the exercise to come back to later.”

That is one learner's approach to textbook problems, not a prescribed waiting time for your readers. It suggests a design question worth answering: what should your exercise preserve when someone pauses? Original comment.

For a professional method, the pause output might be a partial worksheet with one unresolved question and the information needed to answer it. That can be more useful than forcing a confident final answer.

Inspect the static exercise before adding branches

For each prompt in the original exercise, note five things:

QuestionWhy it matters
What decision does this prompt support?Removes questions that have no role in the result.
What would a usable answer contain?Gives feedback a concrete standard.
What mistake do readers make here?Identifies where a hint or example belongs.
Which fact would change the next step?Defines a meaningful branch.
What should happen if the reader does not know?Prevents guesses from becoming false facts.

Keep the original wording nearby. If you revise the exercise's method as well as its format, make that an explicit author decision. Otherwise, it will be difficult to tell whether a later problem came from the interaction or from changing the teaching itself.

Some exercises should remain simple. If the reader can complete the page accurately with one example, a better example may be the entire improvement you need.

Worked example: define the boundary of a small project

Imagine a fictional book about running manageable internal projects. One exercise asks the reader to complete four blanks:

The project will produce ___. It is finished when ___. It will not include ___. The person who can approve this boundary is ___.

The method's purpose is to distinguish a deliverable from a broader ambition and make approval explicit. It does not authorize the reader to change someone else's commitments.

A reader, Rosa, is preparing a refresh of her team's internal reference page. Her first answer is:

“The project will improve communication. It is finished when everyone is happy. It will not include too much extra work. I guess my manager approves it.”

This answer fills every blank while leaving the boundary unclear. The interactive version should not congratulate her on completion or replace her answer with invented organizational facts.

First, identify the most consequential gap

A useful response could be:

“What specific thing will the project create or change? For example, a revised reference page is a deliverable; improved communication is a broader hoped-for result. Describe the thing your team will be able to review.”

This is an authored example of expected behavior, not a model response. It explains the relevant distinction and asks for one decision.

Suppose Rosa replies that the deliverable is a reference page containing current team contacts and links to five frequently used procedures. The skill can now use that answer rather than continuing to ask the opening question in different words.

Then, turn vague completion into an inspectable condition

The next question should address “everyone is happy”:

“Who will review the page, and what must they check before it can be called complete?”

If Rosa names her manager but does not know the review criteria, the skill can suggest criteria for her to confirm: contacts checked, links tested, five procedures included, and manager review recorded. It must label those as proposed criteria rather than existing agreements.

The distinction matters. A plausible completion standard can still be wrong for the actual project.

Write the branch table before writing the full instructions

Use a compact table to define how the exercise responds to different answers.

Reader answer or conditionIntended responseWhat the skill must avoid
Names a concrete deliverableMove to completion criteria.Repeating the same question unnecessarily.
Gives only an aspirationExplain the distinction and ask for a reviewable artifact.Inventing the project's deliverable.
Gives unclear completion criteriaAsk who reviews and what they check; offer labeled suggestions if useful.Treating a suggestion as approved.
Cannot name an approverMark approval unresolved and draft a clarification question.Guessing from job titles.
Lists work outside their authorityStop before recommending a commitment; ask what they can decide.Making an organizational decision for them.
Wants to pauseReturn the partial worksheet and the next missing fact.Marking the exercise complete.

The table is a proposed design for this fictional method. It is not a claim that writing these rules guarantees an AI system will follow them.

Only branch on distinctions that matter. If changing an answer would not change the feedback or next action, you may not need to ask that question at all.

Show a completed answer and an unresolved answer

After clarification, an illustrative worksheet might look like this:

FieldReviewed draft
DeliverableOne updated internal reference page with team contacts and links to five named procedures.
CompletionContacts checked with owners; links open correctly; manager has reviewed the page. Criteria proposed for confirmation.
ExclusionsRewriting the five procedures; changing team responsibilities; migrating other pages.
ApproverRosa believes her manager approves; confirmation still needed.
Next actionAsk the manager to confirm the boundary and review criteria.

This is a useful partial result, but it is not an approved project boundary. The output should say so.

A completed version would replace the unresolved approval note with the reader's confirmation and retain the actual agreed criteria. If Rosa reports that the manager wants one procedure rewritten, the skill should update the scope and revisit the exclusions. It should not keep the old boundary merely because it was produced earlier in the conversation.

Show both kinds of output in your authoring materials. Readers need to see that an honest incomplete result is an acceptable stopping point.

Make feedback specific enough to teach

Compare two responses to Rosa's original answer.

“Great start! Be more specific” offers encouragement but does not identify the problem.

“Your deliverable describes a hoped-for improvement. Name the page, document, event, or other thing someone can review” points to a distinction the reader can use again.

When offering an example, label it as an example. When rewriting the reader's answer, show what changed and ask them to check it. Do not praise an unsupported fact because it makes the worksheet look tidy.

Keep your own criteria close to the feedback rules. If a reader asks why “everyone is happy” is insufficient, the skill should explain that the condition lacks an identified reviewer and observable checks. It should not manufacture a universal management law.

Preserve a useful pause point

A reader may stop because they need another person's answer, want to think, or simply run out of time. Define what the skill should return at that point:

  • The answers already supplied.
  • Which suggestions remain unconfirmed.
  • The specific missing information.
  • A short question they can take to the relevant person.
  • The step to resume after they obtain it.

Do not promise persistent memory unless the delivery environment actually provides it. A copyable summary works as a design requirement even when the reader needs to save and paste it back themselves.

When they return, ask them to confirm whether anything has changed. Resuming from a summary should not mean treating old assumptions as current facts.

Test the branches, including the uncomfortable ones

Before release, use scenarios for a clear answer, a vague answer, missing authority, contradictory information, and a request to pause. Compare actual behavior with the branch table.

Also check whether the skill does too much. Can the reader explain the boundary after receiving help, or have they merely accepted a polished paragraph? That question matters if the exercise is meant to teach a distinction, though a single check does not establish a learning outcome.

The agent skill testing guide provides execution checks. The skill-writing guide explains how to package instructions and examples once your interaction design is clear.

Bring one exercise and its difficult answers

Choose an exercise you know well. Prepare its purpose, a weak answer, a strong answer, and a case where the reader should pause. These materials make the authoring conversation concrete.

If you want to develop that exercise into an author skill, visit Skillfully and choose Book onboarding. Bring the original worksheet and the judgments you want the interaction to teach.