excalidash-c4-context

Generates C4 Level 1 system-context diagrams in Excalidraw via MCP tools.

2|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/gabedsam01/excalidash-v2 --skill excalidash-c4-context-gabedsam01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: excalidash-c4-context
Source: https://github.com/gabedsam01/excalidash-v2/tree/main/skills/excalidash/excalidash-c4-context
Command: npx skills add https://github.com/gabedsam01/excalidash-v2 --skill excalidash-c4-context-gabedsam01

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Creating a clear C4 System Context diagram by hand is slow and error-prone: actors, external systems, and labeled relationships must be laid out around one central system, kept readable, and validated against quality rules. This Skill automates that entire workflow through the ExcaliDash MCP server. ## Core Features & Use Cases - Guided C4 Level 1 generation: Produces a system-context view with exactly one central system, surrounding actors and external systems, labeled relationships, and a legend distinguishing person / system / external system. - Mandatory quality loop: Runs lint, score, repair, polish, and architecture validation until the drawing scores at least 95 with zero hard blockers, with rollback to saved checkpoints on regressions. - Library and secret handling: Places normalized icons from personal template libraries per the MCP_LIBRARY_MODE policy, and redacts credentials (API keys, database URLs, webhook tokens) before any tool call. - Use Case: Ask for a system-context diagram of an Internet Banking System showing customers, the mainframe, and an email service; the Skill generates, validates, saves, and exports the diagram as SVG or PNG. ## Quick Start Ask the AI to draw a C4 system-context diagram for your system, naming its users and the external systems it integrates with.

Frequently Asked Questions about excalidash-c4-context

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

FAQPage Schema
How do I create a C4 system context diagram with Excalidraw?

Describe one central system, its human actors, and the external systems it integrates with, plus a short phrase per relationship. The Skill generates the diagram via MCP tools, then lints, scores, repairs, validates, saves, and exports it as SVG, PNG, or JSON.

What is the difference between C4 context and container diagrams?

A context diagram (Level 1) shows one system as a single box with its users and external integrations. A container diagram (Level 2) shows internal parts like web apps, APIs, and databases. This Skill handles only Level 1 and redirects internal-structure requests to the C4 Container skill.

Can I add vendor logos like Stripe or Auth0 to the diagram?

Yes, when MCP_LIBRARY_MODE is curated or required, icons from your personal template libraries are inserted into normalized slots such as actor, inside-card-left, or badge. Icons that cause density or collision issues are rejected in favor of plain labeled boxes.

What quality score must a C4 context diagram reach?

The diagram must score at least 95 with zero hard blockers such as ARROW_TEXT_INTERSECTION, FRAME_TITLE_OVERLAP, or ITEM_OUTSIDE_FRAME. The repair loop is mandatory below that threshold, and any repair or polish pass that lowers the score is rolled back.

How are secrets handled when describing system integrations?

Credentials such as database URLs, API keys, and webhook tokens are redacted into typed placeholders like [REDACTED_DATABASE_URL] before any tool call. The exported drawing is re-scanned as a backstop, and detected secrets are never echoed back.

When should I not use a system context diagram?

Avoid it when you need internal containers or components, time-ordered message flows, or more than one central system. Those cases call for the C4 Container or Component skills, a sequence diagram, or one context diagram per system.