developer-tutorial

Writes and audits developer tutorials with learning objectives, concept ladders, checkpoints, and verification protocols.

2|Updated Sep 6, 2026
One-click install
npx skills add https://github.com/samber/developer-relations-skills --skill developer-tutorial-samber
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: developer-tutorial
Source: https://github.com/samber/developer-relations-skills/tree/main/skills/developer-tutorial
Command: npx skills add https://github.com/samber/developer-relations-skills --skill developer-tutorial-samber

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Most developer tutorials fail silently: readers abandon at a broken step, copy-paste their way to a working app without learning anything, or discover a hidden prerequisite halfway through. This Skill turns tutorial writing into a disciplined process so the page actually transfers a skill instead of demoing the product. ## Core Features & Use Cases - Greenfield tutorial authoring: Runs a structured interview, applies backward design (objective first, then evidence, then steps), builds a concept ladder with a chosen stop rung, and drafts the page against a section-by-section outline template. - Tutorial audits: Requires cold runs by level-matched learners, then returns a step-keyed defect table classifying each issue as defect, hidden prerequisite, concept gap, or friction, ordered by learners blocked. - Scope calls and measurement: Distinguishes tutorials from how-to guides and quickstarts using Diátaxis, and defines Kirkpatrick-sorted KPIs including transfer tests, per-checkpoint drop-off, and downstream product behavior. - Use Case: A docs lead says "nobody finishes our webhooks tutorial." The Skill prescribes cold-run verification, identifies that step 4 introduces three concepts at once, and returns a prioritized fix table rather than a prose critique. ## Quick Start Ask the assistant to write a tutorial teaching developers to stream responses from your SDK, or to audit an existing tutorial that learners abandon.

Frequently Asked Questions about developer-tutorial

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a developer tutorial that people actually finish?

Start with a testable learning objective before drafting any steps, then build a concept ladder introducing one new concept per step. Place checkpoints every 3-5 steps with exact expected output and a recovery route, and verify the page with a cold run by someone matching the declared audience level.

What is the difference between a tutorial and a how-to guide?

A tutorial is learning-oriented and serves the reader at study; a how-to guide is task-oriented and serves the reader at work. Diátaxis calls conflating the two the single most common conflation in software documentation, because a how-to forks on the reader's situation while a tutorial guarantees one path.

How long should a developer tutorial be?

The Good Docs Project's tutorial template states 15 to 60 minutes end to end, with at most seven primary steps and four substeps per step. If a measured run exceeds 60 minutes, split the tutorial at a checkpoint into two tutorials with a stated order.

How do I stop learners from copy-pasting through the whole tutorial?

Fade the guidance: give full runnable files early, only the added lines with a named insertion point in the middle, and just the requirement plus expected output late. Finish with a transfer test where the learner performs the objective unaided on a variation never demonstrated.

Is there an industry-standard completion rate for tutorials?

No trustworthy published completion benchmark exists for developer tutorials; the activation figures quoted in marketing material are self-reported vendor signup-funnel numbers. Compare each tutorial's completion rate against its own previous version instead of an external target.

When should I use a quickstart instead of a tutorial?

Use a quickstart when the goal is one fast proof that the product works with no skill transfer. Use a tutorial when the learner must be able to perform a capability afterwards, having built a working thing themselves along the way.