К основному содержанию
скилл CX Codex

tutorial-design — скилл для Claude Code: что делает и как установить

Скилл tutorial-design помогает проектировать пошаговые туториалы, воркшопы и практические руководства с контрольными точками и разбором частых ошибок.

MIT 102 установок ★ 71 обновлён 2026-06-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add NickCrew/Claude-Cortex --skill tutorial-design -a claude-code
Открыть на GitHub

Что делает tutorial-design

Скилл выстраивает методический процесс из пяти этапов: определение измеримых целей, декомпозиция темы на атомарные шаги, проектирование упражнений с чекпоинтами, написание рабочего кода и валидация. Внутри заложены форматы заданий разной сложности — от заполнения пропусков в синтаксисе до задач на отладку и написания кода с нуля.

Каждый концепт раскрывается по единой схеме: краткое введение, готовый к запуску пример, построчное объяснение и блок устранения неполадок. Для работы навык запрашивает инструменты Read и Write, а также заявляет зависимости от соседних навыков documentation-production и code-explanation.

Без предварительно собранного списка типичных ошибок блок Troubleshooting придётся заполнять вручную, воспроизводя сбои в реальном окружении.

Какие задачи решает

  • составить программу воркшопа или практического занятия
  • написать пошаговый quick-start для библиотеки или API
  • внедрить контрольные чекпоинты и задачи на отладку в документацию
  • разбить сложную архитектурную тему на связные учебные шаги

Примеры запросов агенту

  • Напиши пошаговый туториал по настройке express-сервера с упражнениями и чекпоинтами
  • Сделай пятиминутный quick-start гайд для нашего REST API с блоком troubleshooting
  • Спроектируй практический воркшоп по базам данных с задачами на отладку кода

Как установить tutorial-design

1Через Skills CLI (Vercel)

npx skills add NickCrew/Claude-Cortex --skill tutorial-design -a claude-code

2Вручную: положить файлы

~/.claude/skills/tutorial-design/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tutorial-design/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о tutorial-design

Как установить tutorial-design в Claude Code?

Выполните команду npx skills add NickCrew/Claude-Cortex --skill tutorial-design -a claude-code. Конфигурация навыка сохранится в ~/.claude/skills/tutorial-design/SKILL.md.

Что делает скилл tutorial-design?

Он направляет подготовку обучающих материалов по пятифазному пайплайну: от формулирования целей через глаголы действий до сквозной проверки кода в чистом окружении.

Какие зависимости нужны для работы tutorial-design?

В манифесте указаны навыки documentation-production и code-explanation, а также системные инструменты Read и Write.

Исходный текст

SKILL.md · MIT
---
name: tutorial-design
description: Design and write hands-on tutorials with progressive disclosure, exercises, and troubleshooting sections. Use when creating learning content, workshops, or step-by-step guides.
version: 1.0.0
tags:
  - tutorials
  - pedagogy
  - learning
  - workshops
  - documentation
triggers:
  - write tutorial
  - create workshop
  - step-by-step guide
  - hands-on walkthrough
  - learning content
  - lab exercise
dependencies:
  skills:
    - documentation-production
    - code-explanation
  tools:
    - Read
    - Write
token_estimate: ~2500
keywords:
  - write tutorial
  - learning content
  - hands-on guide
  - tutorial
  - tutorial design
---

# Tutorial Design

Design and write hands-on tutorials that transform complex technical concepts into engaging,
progressive learning experiences with exercises, checkpoints, and troubleshooting guidance.

## When to Use This Skill

- Writing a getting-started tutorial for a library, API, or tool
- Creating workshop materials for team training or conferences
- Building multi-part learning series with progressive difficulty
- Designing coding exercises with self-assessment checkpoints
- Converting existing documentation into guided learning content
- Creating quick-start guides that get users productive fast

## Quick Reference

| Resource | Purpose | Load when |
|----------|---------|-----------|
| `references/design-patterns.md` | Progressive disclosure patterns, exercise types, checkpoint design, difficulty calibration, prerequisite mapping | Planning tutorial structure or designing exercises |

---

## Workflow Overview

```
Phase 1: Objectives   → Define learning outcomes, prerequisites, and audience
Phase 2: Decompose    → Break concepts into atomic, sequenced steps
Phase 3: Design       → Create exercises, checkpoints, and troubleshooting tips
Phase 4: Write        → Produce tutorial content with runnable examples
Phase 5: Validate     → Test the tutorial path end-to-end
```

---

## Phase 1: Define Learning Objectives

Every tutorial starts with clear outcomes.

### Opening Section Template

```markdown
## What You'll Learn

- [Specific, measurable outcome 1]
- [Specific, measurable outcome 2]
- [Specific, measurable outcome 3]

## Prerequisites

- [Required knowledge or setup]
- [Tools needed]

## Time Estimate

~[X] minutes

## What You'll Build

[Brief description or screenshot of the final result]
```

**Writing good objectives:**
- Use action verbs: "build", "configure", "debug", "deploy" — not "understand" or "learn about"
- Make them testable: the reader should be able to verify they achieved each outcome
- Scope realistically: 3-5 objectives per tutorial

---

## Phase 2: Concept Decomposition

Break the topic into atomic learning steps.

### Sequencing Rules

1. **One concept per section** — never introduce two new ideas at once
2. **Dependency order** — concepts must build on what came before
3. **Concrete before abstract** — show the working example, then explain the theory
4. **Simple before complex** — start with the minimal version, layer complexity

### Concept Map

Before writing, sketch a dependency graph:

```
[Prerequisites] → [Core concept A] → [Core concept B]
                                    ↘ [Variation 1]
                  [Core concept A] → [Core concept C] → [Advanced topic]
```

Each node becomes a section. Dependencies become the section order.

---

## Phase 3: Design Exercises and Checkpoints

### Exercise Types

| Type | Difficulty | When to use |
|------|-----------|-------------|
| **Fill-in-the-blank** | Low | Reinforce syntax after an example |
| **Debug challenge** | Medium | Teach error reading and common mistakes |
| **Extension task** | Medium | Add a feature to working code |
| **From scratch** | High | Build based on requirements only |
| **Refactoring** | High | Improve existing implementation |

### Checkpoint Pattern

After every major section, insert a checkpoint:

```markdown
### Checkpoint

At this point you should have:
- [ ] A running server on port 3000
- [ ] The `/health` endpoint returning `{ "status": "ok" }`
- [ ] Server logs showing incoming requests

**If something's wrong**, see the [Troubleshooting](#troubleshooting) section below.
```

### Troubleshooting Sections

For every section, anticipate 2-3 common errors:

```markdown
### Troubleshooting

**Error: `EADDRINUSE: address already in use`**
Another process is using port 3000. Run `lsof -i :3000` to find it,
then stop it or change your port.

**Error: `Cannot find module 'express'`**
You haven't installed dependencies yet. Run `npm install` in the project root.
```

---

## Phase 4: Write the Tutorial

### Section Structure (for each concept)

1. **Brief intro** (1-2 sentences) — what this section covers and why it matters
2. **Minimal example** — complete, runnable code showing the concept
3. **Line-by-line explanation** — walk through the important parts
4. **Try it** — tell the reader to run the code and what to expect
5. **Extend it** — optional exercise to deepen understanding
6. **Troubleshooting** — common errors for this section

### Writing Principles

- **Show, then explain** — code first, theory second
- **Frequent validation** — readers should run code every 2-3 minutes
- **Fail forward** — include intentional errors to teach debugging
- **Incremental complexity** — each step adds one thing to the previous
- **Copy-paste friendly** — examples must work when pasted directly

### Content Elements

**Code blocks must:**
- Be complete and runnable (no `...` elisions in critical paths)
- Include expected output in a separate block
- Use meaningful variable names
- Have inline comments only where non-obvious

**Explanations should:**
- Connect to real-world use cases
- Provide the "why" behind each step
- Use analogies to familiar concepts
- Anticipate the reader's "but what about...?" questions

### Closing Section

```markdown
## Summary

You've learned how to:
- [Outcome 1 restated]
- [Outcome 2 restated]

## Next Steps

- [Natural follow-on tutorial or topic]
- [Related documentation]
- [Community resources]
```

---

## Phase 5: Validate

Before publishing, test the entire tutorial path:

1. Follow every step from a clean environment
2. Run every code example and verify output matches
3. Trigger every troubleshooting scenario at least once
4. Time the tutorial — does it match the estimate?
5. Have someone unfamiliar with the topic attempt it

---

## Tutorial Formats

| Format | Duration | When to use |
|--------|----------|-------------|
| **Quick Start** | 5 min | First contact, get running fast |
| **Deep Dive** | 30-60 min | Comprehensive single-topic exploration |
| **Workshop Series** | Multi-part | Progressive learning across sessions |
| **Cookbook** | Variable | Problem-solution pairs, non-linear reading |
| **Interactive Lab** | 15-45 min | Hands-on environment with guided steps |

## Anti-Patterns

- Introducing concepts before they are needed ("you'll use this later")
- Showing code snippets that cannot run standalone
- Assuming knowledge not listed in prerequisites
- Walls of text without code breaks
- Exercises without solutions (even collapsed/hidden ones)
- Skipping the "why" and only showing the "how"

© NickCrew · MIT · NickCrew/Claude-Cortex

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
tutorial-docs existential-birds Скилл tutorial-docs для Claude Code задаёт структуру обучающих руководств по методологии Diataxis. Агент подключает его при написании вводных уроков и пошаговых руководств для новичков. CX Codex +1 273установок code-documentation-tutorial-engineer Seth Hobson Субагент code-documentation-tutorial-engineer превращает исходный код в пошаговые обучающие материалы и руководства по онбордингу. Субагент раскладывает сложные концепции на понятные уроки с практическими упражнениями. CX Codex ★ 42 780звёзд репо tutorial-creation vivy-yi Скилл tutorial-creation для создания пошаговых обучающих материалов на Xiaohongshu. Помогает структурировать контент так, чтобы подписчики поняли и смогли применить знания. CX Codex +1 178установок learning-guide SuperClaude-Org Субагент learning-guide для Claude Code пошагово объясняет код и программные концепции на рабочих примерах и упражнениях. Помогает разобраться в теме, а не получить готовый ответ. CX Codex ★ 23 950звёзд репо workshop-program-design Samuel Berthe Скилл workshop-program-design помогает спланировать технический воркшоп: рассчитать число ассистентов, требования к ноутбукам и действия при сбое Wi-Fi. CX Codex +1 6 700установок developer-tutorial Samuel Berthe Скилл developer-tutorial для Claude Code пишет или аудирует обучающие туториалы по продукту: читатель шаг за шагом собирает работающий проект и осваивает навык. CX Codex +1 13 500установок

Из того же набора21

Весь набор →
event-driven-architecture Скилл event-driven-architecture для Claude Code помогает проектировать системы на событиях: event sourcing, CQRS, саги и обмен сообщениями. Охватывает микросервисы и распределённые транзакции. CX Codex +1 118установок dashboard-designer Скилл dashboard-designer для Claude Code помогает спроектировать дашборд: выбрать KPI, расположить блоки и настроить визуальную иерархию. Запускается на запросы о структуре панели мониторинга или выборе BI-инструмента. CX Codex +1 109установок terraform-best-practices Скилл terraform-best-practices внедряет инженерные стандарты Terraform: разбиение на модули, блокировку стейта, разделение сред и валидацию в CI/CD. CX Codex +1 109установок mermaid-diagramming Скилл mermaid-diagramming учит агента рисовать диаграммы Mermaid: блок-схемы, sequence-диаграммы, ERD, состояния, Gantt и архитектурные виды, отдельно базовую и стилизованную версию. CX Codex +1 105установок kubernetes-security-policies Скилл kubernetes-security-policies для Claude Code помогает настроить Pod Security Standards, сетевые политики и RBAC в Kubernetes. Ужесточает защиту прод-окружения. CX Codex +1 104установок user-journey-mapping Скилл user-journey-mapping для Claude Code помогает составить карту пути пользователя с этапами, точками контакта, эмоциями и проблемами. Запускается при анализе пользовательского опыта или конверсии. CX Codex +1 102установок requirements-discovery Скилл requirements-discovery для Claude Code помогает собирать требования, определять границы проекта и готовить PRD. Запускается при обсуждении новой функции, интервью со стейкхолдерами или проверке спецификации. CX Codex +1 101установок api-gateway-patterns Скилл api-gateway-patterns для проектирования API-шлюзов в микросервисных архитектурах: маршрутизация, аутентификация, rate limiting, композиция запросов. CX Codex +1 101установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой