Skip to content
Skills Library
Education · Building & coding

courseware-builder

/courseware-builder

Interactive HTML courseware builder — turns any technical topic, flow, or process into a CD-Courseware-style interactive slide deck with animated diagrams, step-by-step simulation, syntax-highlighted code examples, and key points panels. Use this skill whenever the user wants to create teaching materials, interactive slides, animated flow diagrams, or step-by-step technical walkthroughs — even if they say "buatkan slides untuk topik X", "jadikan courseware", "buat interactive tutorial", or "create a lesson on X". Also triggers for "convert my diagram to interactive slides" or "build a visual w

Repository
claude ↗
Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
4
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Interactive HTML courseware builder — turns any technical topic, flow, or process into a CD-Courseware-style interactive slide deck with animated diagrams, step-by-step simulation, syntax-highlighted code examples, and key points panels. Use this skill whenever the user wants to create teaching materials, interactive slides, animated flow diagrams, or step-by-step technical walkthroughs — even if they say "buatkan slides untuk topik X", "jadikan courseware", "buat interactive tutorial", or "create a lesson on X". Also triggers for "convert my diagram to interactive slides" or "build a visual w

Triggers from the description

buatkan slides untuk topik Xjadikan coursewarebuat interactive tutorialcreate a lesson on Xconvert my diagram to interactive slides
Original author description

Interactive HTML courseware builder — turns any technical topic, flow, or process into a CD-Courseware-style interactive slide deck with animated diagrams, step-by-step simulation, syntax-highlighted code examples, and key points panels. Use this skill whenever the user wants to create teaching materials, interactive slides, animated flow diagrams, or step-by-step technical walkthroughs — even if they say "buatkan slides untuk topik X", "jadikan courseware", "buat interactive tutorial", or "create a lesson on X". Also triggers for "convert my diagram to interactive slides" or "build a visual w

How it works

  1. Phase 1 — Topic Discovery Interview
  2. Phase 2 — Content Architecture
  3. Phase 3 — Generate HTML Courseware
  4. Phase 4 — Output
  5. Reference Files
Original SKILL.md headings · 202 lines, 1,141 words
SKILL.md preview
---
name: courseware-builder
metadata:
  compatible_agents:
    - claude-code
    - laravel-cloud
  tags:
    - courseware
    - interactive
    - html
    - teaching
    - slides
    - animation
    - diagram
    - tutorial
    - training
description: >
  Interactive HTML courseware builder — turns any technical topic, flow, or process into a
  CD-Courseware-style interactive slide deck with animated diagrams, step-by-step simulation,
  syntax-highlighted code examples, and key points panels. Use this skill whenever the user wants
  to create teaching materials, interactive slides, animated flow diagrams, or step-by-step
  technical walkthroughs — even if they say "buatkan slides untuk topik X", "jadikan courseware",
  "buat interactive tutorial", or "create a lesson on X". Also triggers for "convert my diagram
  to interactive slides" or "build a visual walkthrough for my training".
---

# Courseware Builder

Transform any technical topic into a self-contained interactive HTML courseware file — CD-Courseware-style with animated flow diagrams, step-by-step simulation, syntax-highlighted code examples, and key points panels. Zero external dependencies (except optional Google Fonts CDN).

---

## Phase 1 — Topic Discovery Interview

Ask the user conversationally in **one message** for the following:

1. **Topic** — what are we teaching?
2. **Target audience** — beginners, intermediate, advanced? developers, managers, students?
3. **Language preference** — BM / EN / mixed
4. **Existing outline** — does the user already have a flow, diagram, or step list?
5. **Code language/framework** — PHP, JS, Python, Laravel, etc.
6. **Actors** — who/what is involved in the flow? (e.g. user, server, browser, database)

**Skip this phase** if the user already provided a complete flow, diagram, or step breakdown in their request. Extract the answers from what they gave and confirm before proceeding.

Example interview prompt:

> Nak buat courseware untuk topik apa? Beritahu saya:
> - Topik apa (e.g. "OAuth2 Authorization Code Flow")
> - Untuk siapa (beginner/intermediate/advanced)
> - Bahasa (BM/EN/campur)
> - Ada outline/diagram sedia ada?
> - Bahasa code (PHP/JS/Python/etc.)
> - Siapa actors dalam flow ni? (user, server, browser, db, etc.)

---

## Phase 2 — Content Architecture

Map the topic into **6–12 steps**. Each step must include:

| Field | Description | Rules |
|-------|-------------|-------|
| `title` | Short action phrase | Max 5 words, starts with verb |
| `desc` | What happens + why it matters | 2–3 sentences |
| `actors` | Entities involved in this step | Pick from: `user`, `server`, `browser`, `keycloak`, `gateway`, `db`, `queue`, `external` |
| `points` | Key takeaways | 3–5 items, each typed as `info` / `warn` / `danger` / `success` |
| `code` | Relevant code snippet | Include filename as comment, syntax-highlight via CSS spans |
| `activeStep` | 0-indexed node position | Which node in the flow diagram to highlight |

Refer to `references/step-templates.md` for detailed schema, actor definitions, point type conventions, and content writing guide.

### Architecture Output

Present the step map as a numbered list for user review before generating HTML:

```
Step 1: [title] — [1-line desc] — actors: [list] — active node: [n]
Step 2: ...
```

Wait for user confirmation or adjustments before proceeding to Phase 3.

---

## Phase 3 — Generate HTML Courseware

Generate a **single self-contained HTML file** with zero external dependencies (except optional Google Fonts CDN link).

### Layout Structure

```
┌─────────────────────────────────────────────────────┐
│ HEADER: [brand-left] [course-title-center] [n/N-right] │
├──────────────┬──────────────────────────────────────┤
│  LEFT PANEL  │           RIGHT PANEL                │
│  (330px)     │                                      │
│              │  ┌──────────────────────────────┐    │
│  Step Badge  │  │     FLOW DIAGRAM              │    │
│  Title       │  │  (animated nodes + arrows)    │    │
│  Description │  │                                │    │
│  Actor Tags  │  └──────────────────────────────┘    │
│  Key Points  │  ┌──────────────────────────────┐    │
│              │  │     CODE PANEL                │    │
│              │  │  (syntax highlighted)         │    │
│              │  └──────────────────────────────┘    │
├──────────────┴──────────────────────────────────────┤
│ FOOTER: [◀ Prev] [● ● ● ● ●] [Next ▶] [▶ Simulate] │
│         [═══════════ progress bar ═══════════════]   │
└─────────────────────────────────────────────────────┘
```

### Components

- **Header**: Brand name left, course title center, step counter (`n / N`) right
- **Left Panel** (330px fixed):
  - Step badge (numbered circle)
  - Step title (bold heading)
  - Step description (paragraph)
  - Actor tags (colour-coded pill badges per actor)
  - Key points (colour-coded cards: info=blue, warn=amber, danger=red, success=green)
- **Right Panel** (flexible):
  - Flow diagram: all nodes always visible, active node = highlighted + scaled, completed nodes = green with ✓
  - Code panel: syntax-highlighted snippet with filename header
- **Footer**:
  - Prev / Next buttons
  - Clickable step dots (filled = visited, ring = current, empty = unvisited)
  - Progress bar (smooth transition)
  - ▶ Simulate button (auto-play all steps)

### Interactions

| Trigger | Action |
|---------|--------|
| Next / Prev buttons | Navigate steps |
| Step dot click | Jump to step |
| Node click | Jump to that node's step |
| ▶ Simulate | Auto-play at 900ms/step with packet animation along arrows |
| `→` or `Space` | Next step |
| `←` | Previous step |
| `Enter` | Start/stop simulate |

### Syntax Highlighting

CSS-only syntax highlighting via span classes — **no external libraries**:

| Class | Purpose | Example colour |
|-------|---------|----------------|
| `.kw` | Keyword | `#c792ea` (purple) |
| `.fn` | Function name | `#82aaff` (blue) |
| `.str` | String literal | `#c3e88d` (green) |
| `.cmt` | Comment | `#546e7a` (grey) |
| `.var` | Variable | `#f78c6c` (orange) |
| `.cls` | Class name | `#ffcb6b` (gold) |
| `.num` | Number | `#f78c6c` (orange) |
| `.arr` | Arrow / operator | `#89ddff` (cyan) |

### Animations

- **Slide-in**: left panel content slides in on step change (CSS `translateX` + `opacity`)
- **Node active**: scale 1.15 + glow box-shadow on active node
- **Packet animation**: a dot travels along the arrow path from source to target node during simulate
- **Progress bar**: smooth `transition: width 0.4s ease`
- **Notify toast**: brief toast message on simulate start/end

### Themes

Three built-in themes defined in `references/themes.md`:

| Theme | Audience | Default? |
|-------|----------|----------|
| **Dark Cyberpunk** | Developers, tech workshops | Yes |
| **Light Editorial** | Non-technical, management, students | No |
| **Warm Malaysian** | Community events, BM workshops | No |

Select theme based on target audience from Phase 1. User can override.

Refer to `references/html-template.md` for the complete HTML boilerplate, render function, simulate function, keyboard handler, and CSS patterns.

---

## Phase 4 — Output

### File Naming

```
{topic-slug}-courseware.html
```

Examples:
- `oauth2-auth-code-flow-courseware.html`
- `laravel-request-lifecycle-courseware.html`
- `git-branching-strategy-courseware.html`

### Quality Checklist

Before saving the file, verify:

- [ ] All steps have complete content (title, desc, actors, points, code, activeStep)
- [ ] Flow diagram renders all nodes with correct active highlighting
- [ ] Simulate auto-plays through all steps with packet animation
- [ ] Keyboard navigation works (→/Space, ←, Enter)
- [ ] Step dots are clickable and reflect current position
- [ ] Progress bar updates smoothly
- [ ] Zero external dependencies (except optional Google Fonts CDN)
- [ ] Code snippets have proper syntax highlighting
- [ ] Actor tags display with correct colours
- [ ] Key points cards show correct type styling (info/warn/danger/success)

### Delivery

Save the file and present it to the user. Include in the summary:

- Total step count
- Keyboard shortcuts reminder: `→`/`Space` = next, `←` = prev, `Enter` = simulate
- File path

---

## Reference Files

| File | Purpose |
|------|---------|
| `references/step-templates.md` | Step content schema, actor definitions, point types, writing guide |
| `references/themes.md` | CSS variables, font pairings, theme selection guide for all 3 themes |
| `references/html-template.md` | Complete HTML boilerplate, render/simulate functions, CSS patterns |
Files in this package (4)
  • SKILL.md 9 KB
  • references/html-template.md 24 KB
  • references/step-templates.md 8 KB
  • references/themes.md 6 KB

Versions

The database has no other skills named courseware-builder.

Database snapshot: 13.11.2026 · package version fba06b338cbf (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100wps-courseware
    教学课件制作。老师和培训师的做课件助手,按照"导入→新授→练习→总结"的 教学设计结构自动生成课件PPT,帮你拆解知识点、设计互动环节、生成练习题。 用于帮助教师快速制作课件。当用户提到课件、教学PPT、培训材料时触发。 Courseware maker for teachers with structured lesson design.
  • 82slides-builder
    Generate a complete HTML slide deck from a topic, bullet list, or document. McKinsey-style — one insight per slide, no filler. Use when the user wants to build a presentation, pitch deck, or teaching slide deck.
  • 87teaching-suite
    Codex-native Teaching Skills suite for university professors — the full teaching lifecycle: course design, lesson building, assessment, student mentoring, submission auditing, reflection, plus slide-deck rendering, executable labs, video scripting, course publishing, TA…
  • 100visual-explainer
    Build a clickable, visual explainer that teaches a hard topic from zero — a single self-contained HTML page with chapters, stepped narration and hand-drawn interactive SVG diagrams instead of walls of text. Use when someone asks to learn or teach a subject properly, wants an…
  • 100courseware-cn-annotator
    当用户说“做成学习包”(例如“把这份课件做成学习包”)时,使用本技能。把课件、讲义或课堂 PPT 的 PDF 一次性做成中文学习包:逐页中文翻译、面向零基础读者的三问式逐页注释(这页在说什么、为什么、怎么用)、可直接编辑的 Markdown 源稿、离线单文件 HTML 电子书(分组目录、全文搜索、注释与原图开关、深色主题、键盘翻页、深链)、A4 打印 PDF、使用说明,以及一到两篇学科速查附录。用户提供课件 PDF 并提到翻译、逐页讲解、注释版、电子书、可打印讲义、复习资料、速查表等任一需求时,也使用本技能,即使没有明确说“技能”。默认一次产出全套,用户明确只要其中某几项时才裁剪。
  • 100animaguru-diagram-formula-motion
    Build animated diagrams, plotted geometry and equation transformations for visual explanation. Use for the Diagram and Formula Motion visual style in an AnimaGuru video workspace.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.