whiteboard

Guides learners to sketch Mermaid architecture diagrams before writing any code.

2|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/jay-steenbergen/MSSAMentorAgent --skill whiteboard-jay-steenbergen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: whiteboard
Source: https://github.com/jay-steenbergen/MSSAMentorAgent/tree/main/.github/skills/methods/whiteboard
Command: npx skills add https://github.com/jay-steenbergen/MSSAMentorAgent --skill whiteboard-jay-steenbergen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Learners often jump into code without understanding the system they are building, losing the big picture when a project has multiple moving parts. This Skill enforces a diagram-first teaching method where a Mermaid sketch becomes the source of truth before any code is written. ## Core Features & Use Cases - Diagram-first workflow: The mentor renders a Mermaid diagram of 8 boxes or fewer, the learner walks it out loud as a comprehension gate, and only then does coding begin. - One-box-at-a-time builds: Each diagram box is translated into a single code change, with stubs for missing dependencies, and boxes are marked done as they are completed. - Drift management: Whenever code diverges from the sketch, the session stops and the diagram is updated so the picture never lies about the system. - Use Case: A learner who knows REST and SQL separately but has never wired them together sketches an API-plus-database flow, narrates it, then builds each box one at a time. ## Quick Start Ask the mentor to use the whiteboard method to design and build a small multi-component system with you, starting from a Mermaid diagram.

Frequently Asked Questions about whiteboard

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

FAQPage Schema
How do I teach system design before writing code?

Use a diagram-first method: sketch the system as a Mermaid flowchart with plain-English labels, have the learner narrate the flow box by box, then translate one box at a time into code. The diagram stays the source of truth for the whole session.

How to use Mermaid diagrams in a coding tutoring session?

Render a Mermaid flowchart TD, sequenceDiagram, or classDiagram in chat with at most 8 nodes. Ask the learner what is confusing, what to rename, and what is missing, then edit the diagram until they can read every label without explanation.

When should I use whiteboard instead of TDD or ride-along?

Use whiteboard when the build has three or more moving parts or the learner is confused about what calls what. Use TDD when behavior is specified and the question is correctness, BDD when behavior is fuzzy, and ride-along for single-function builds.

What are the limitations of a diagram-first teaching method?

Diagrams over 8 boxes overwhelm learners, so larger systems must be split into two sessions. The method also fails if the diagram goes stale, so every code change that diverges from the sketch requires stopping and updating the picture.

Can whiteboard help with system design interview preparation?

Yes, the method mirrors the interview format: sketch on a whiteboard, narrate the flow out loud, and adjust the design under questioning. Practicing builds this way directly trains the skills the interview evaluates.