Overview Start Personal Assistant Files Routine Research Big Projects Changes & Fixes Shutdown
Skill Workflow · Step 04
04

Write Instructions

Numbered steps, one to three sentences each. Built so a new hire could follow them.

When to do this

Output standard is locked, knowledge files exist. Now you write the playbook: what Claude does, in what order, with what.

The format that works

Numbered steps. Each step one to three sentences. Each step answers three questions:

  • What happens in this step?
  • With which input or file?
  • What is the output of this step?

Write like a manager, not a coder

Write the way you would explain it to a new hire on day three. Plain language, real verbs, no abstractions. "Read the knowledge file, pick three patterns, use them in the outline" beats any clever prompt-engineering line.

Where instructions die

Vague verbs

"Be creative", "make it compelling", "use your judgment". Claude cannot act on these. Replace with: "Pick three of five options from the list", "Keep it under 120 words", "Pattern after example_2.md".

When you ask for a decision

Always give criteria. Not: "Choose the best framework." But: "Choose the framework where the prospect's main pain matches the first column. If two match, take the one with the shorter explanation."

Now do it

Prompt
Continue with skill-creator. Step 4: write instructions.

Use the knowledge files. Build SKILL.md with:
- proper frontmatter (name, description)
- numbered steps, 1–3 sentences each
- each step answers: what, with what input, what output
- vague verbs replaced with concrete criteria
- decisions include selection criteria

Save it next to the knowledge files.
Key Rule
Output of this step: a numbered step-by-step doc.

If you cannot hand it to a new hire and have them produce the right output by following it, the skill is not ready yet. Tighten the steps until they could.