tutorial-spec

Generate a TUTORIAL_SPEC.md from STATUS.md, GOAL.md, and DECISIONS.md.

497|38|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/WILLOSCAR/research-units-pipeline-skills --skill tutorial-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tutorial-spec
Source: https://github.com/WILLOSCAR/research-units-pipeline-skills/tree/main/.codex/skills/tutorial-spec
Command: npx skills add https://github.com/WILLOSCAR/research-units-pipeline-skills --skill tutorial-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill standardizes the initial planning phase of tutorial creation by defining its scope, target audience, learning objectives, and a consistent running example, preventing scope creep and ensuring clarity before content development begins.

Core Features & Use Cases

  • Scope Definition: Clearly outlines what the tutorial will cover and explicitly states non-goals.
  • Objective Setting: Establishes measurable learning outcomes for participants.
  • Audience & Prerequisites: Identifies the intended learner and their required prior knowledge.
  • Running Example: Selects a consistent, simple example to be used throughout the tutorial modules.
  • Use Case: Before building a new tutorial on "Advanced Git Branching Strategies," use this Skill to define that it's for intermediate developers, will cover rebase and merge strategies, but will not cover Git hooks or Git LFS, and will use a sample project with three developers.

Quick Start

Use the tutorial-spec skill to define the scope for a new tutorial on Python decorators.

Frequently Asked Questions about tutorial-spec

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

FAQPage Schema
How do I define scope and learning objectives for a new tutorial?

Defining tutorial scope involves outlining covered topics, stating explicit non-goals, and setting measurable learning outcomes. Using a tutorial specification ensures clear boundaries and establishes target audience prerequisites before content development begins.

What is the best way to prevent scope creep when designing curriculum?

Preventing scope creep requires creating a formal tutorial specification that explicitly states non-goals and defines a consistent running example. This standardized planning phase ensures deterministic downstream content creation by establishing clear intent and boundaries early.

How does setting a running example improve tutorial planning?

Setting a running example improves tutorial planning by providing a consistent, simple scenario used throughout all curriculum modules. This approach maintains clarity and coherence for the target audience during downstream content creation.

Do I need structured input files to generate a tutorial spec?

Yes, generating a tutorial spec requires structured input from STATUS.md, GOAL.md, and DECISIONS.md files. Processing these inputs produces a TUTORIAL_SPEC.md output that defines the tutorial's scope, target audience, and measurable objectives.

What limitations should I anticipate when defining tutorial boundaries?

When defining tutorial boundaries, anticipate limitations by explicitly stating non-goals and identifying required audience prerequisites. This prevents scope creep and ensures deterministic downstream planning by restricting the curriculum design to intended learning outcomes.

Can I use tutorial-spec for curriculum design targeting intermediate developers?

Yes, you can use this tutorial specification process for curriculum design targeting intermediate developers. It identifies the intended learner, establishes their required prior knowledge, and defines measurable learning outcomes tailored to that specific audience.