Overview

This skill enables you to generate Excalidraw flowcharts that visualize steps, decisions, and outcomes. It follows a defined workflow where the Tech Writer (Paige) reads the project instructions, builds the diagram in Excalidraw, and then validates the result against a checklist.

How This Skill Works

Triggered by user invocation, Paige, the Tech Writer in the Diagrams phase, reads ./instructions.md to understand scope. She then creates the flowchart in Excalidraw and finally verifies the diagram against ./checklist.md before delivery.

When to Use It

• Documenting a step-by-step business process for onboarding or SOPs
• Visualizing a software workflow or API call sequence for engineers
• Mapping decision points and branching logic for training materials
• Planning project milestones, tasks, and dependencies
• Creating a high-level incident response or support escalation diagram

Quick Start

1. Step 1: Read ./instructions.md to understand scope
2. Step 2: Create the flowchart in Excalidraw following the instructions
3. Step 3: Validate with ./checklist.md and finalize

Best Practices

• Define start and end points before drawing any shapes
• Use consistent shapes for process, decision, and data
• Label arrows and actions succinctly to reduce clutter
• Keep the layout left-to-right with clear flow direction
• Validate the diagram against ./checklist.md after editing

Example Use Cases

• Employee onboarding flowchart
• CI/CD deployment pipeline diagram
• Customer support escalation path
• API integration data flow diagram
• Incident response procedure visualization

Frequently Asked Questions