Technical Book Lab Design
Core Lens
A technical book lab is not a pile of commands. It is a guided reader transformation with a clear starting state, safe path, visible progress, expected output, and exit criteria. The reader should know what they built, why it works, how to verify it, and what to do when it fails.
Use this skill to design or improve:
- Self-hosting chapters.
- DevOps, infrastructure, programming, data, or security tutorials.
- Worked examples and exercises.
- Lab prerequisites and environment assumptions.
- Checkpoints, expected outputs, and troubleshooting branches.
Reference Routing
| Need |
Read |
| Core lab concepts and terminology |
references/core/knowledge.md |
| Lab design rules |
references/core/rules.md |
| Before/after examples |
references/core/examples.md |
| Lab review checklist |
references/core/checklist.md |
| Step-by-step lab design |
workflows/design-runnable-lab.md |
Workflow
1. Name The Reader Outcome
State what the reader will be able to do, decide, deploy, debug, or explain after the lab.
If the outcome is only "learn about X," sharpen it until there is visible proof of progress.
2. Define The Starting State
List what the reader already has and knows:
- Required concepts.
- Accounts, hardware, software, versions, and operating system.
- Network, domain, DNS, permissions, credentials, or safety constraints.
- Files or repo state.
Move missing prerequisites earlier, compress them, or link them to companion material.
3. Design The Path
Structure the lab as small checkpoints:
- Explain the purpose before each action.
- Give the smallest safe command or change.
- Show expected output or state.
- Add a quick verification.
- Explain the next decision.
4. Add Failure Handling
Technical readers do not only need the happy path.
- List likely errors and what they mean.
- Add rollback or cleanup steps where changes are risky.
- Mark steps that expose services, change permissions, spend money, or affect data.
- Tell readers when to stop and ask for help.
5. Close The Loop
End every lab with:
- Final verification.
- What the reader should understand now.
- What they can safely change next.
- Cleanup, maintenance, or security follow-up.
Output Format
When designing or reviewing a lab, return:
- Reader outcome and starting-state assumptions.
- Lab sequence with checkpoints.
- Expected outputs and verification steps.
- Troubleshooting table.
- Safety notes and cleanup.
- Suggested companion resources or prerequisites.
Quality Bar
Make the lab useful to a real reader in a real environment. Prefer concrete outputs, checkpoints, and failure handling over abstract explanation or untested command sequences.
1---2name: technical-book-lab-design3description: Design hands-on technical nonfiction chapters as runnable labs, worked examples, exercises, checkpoints, troubleshooting paths, and reader outcomes. Use when turning technical book sections, tutorials, self-hosting chapters, DevOps guides, programming lessons, or infrastructure explanations into practical labs that readers can complete and verify.4license: MIT5compatibility: Codex, Claude Code, and other Agent Skills-compatible clients.6metadata:7 source: https://skillmd.com/skills/hashgraph-online/technical-book-lab-design8 version: "0.1.0"9 displayName: Technical Book Lab Design10 category: Writing11 tags: writing,books,nonfiction,technical-writing,tutorials12---1314# Technical Book Lab Design1516## Core Lens1718A technical book lab is not a pile of commands. It is a guided reader transformation with a clear starting state, safe path, visible progress, expected output, and exit criteria. The reader should know what they built, why it works, how to verify it, and what to do when it fails.1920Use this skill to design or improve:2122- Self-hosting chapters.23- DevOps, infrastructure, programming, data, or security tutorials.24- Worked examples and exercises.25- Lab prerequisites and environment assumptions.26- Checkpoints, expected outputs, and troubleshooting branches.2728## Reference Routing2930| Need | Read |31|------|------|32| Core lab concepts and terminology | `references/core/knowledge.md` |33| Lab design rules | `references/core/rules.md` |34| Before/after examples | `references/core/examples.md` |35| Lab review checklist | `references/core/checklist.md` |36| Step-by-step lab design | `workflows/design-runnable-lab.md` |3738## Workflow3940### 1. Name The Reader Outcome4142State what the reader will be able to do, decide, deploy, debug, or explain after the lab.4344If the outcome is only "learn about X," sharpen it until there is visible proof of progress.4546### 2. Define The Starting State4748List what the reader already has and knows:4950- Required concepts.51- Accounts, hardware, software, versions, and operating system.52- Network, domain, DNS, permissions, credentials, or safety constraints.53- Files or repo state.5455Move missing prerequisites earlier, compress them, or link them to companion material.5657### 3. Design The Path5859Structure the lab as small checkpoints:6061- Explain the purpose before each action.62- Give the smallest safe command or change.63- Show expected output or state.64- Add a quick verification.65- Explain the next decision.6667### 4. Add Failure Handling6869Technical readers do not only need the happy path.7071- List likely errors and what they mean.72- Add rollback or cleanup steps where changes are risky.73- Mark steps that expose services, change permissions, spend money, or affect data.74- Tell readers when to stop and ask for help.7576### 5. Close The Loop7778End every lab with:7980- Final verification.81- What the reader should understand now.82- What they can safely change next.83- Cleanup, maintenance, or security follow-up.8485## Output Format8687When designing or reviewing a lab, return:88891. Reader outcome and starting-state assumptions.902. Lab sequence with checkpoints.913. Expected outputs and verification steps.924. Troubleshooting table.935. Safety notes and cleanup.946. Suggested companion resources or prerequisites.9596## Quality Bar9798Make the lab useful to a real reader in a real environment. Prefer concrete outputs, checkpoints, and failure handling over abstract explanation or untested command sequences.