- Home
- Skills
- Agents & Orchestration
- diagram design
diagram design
Create professional, brand-aligned technical diagrams as accessible HTML/SVG assets.
Free
Works with the AI Agents you already use
diagram design
Example session with this skill installed
Create an architecture delta diagram for migrating a monolithic auth service to a microservices-based OAuth2 provider. Use the doc-wide size preset and the corporate-dark profile.
- Read your context and instructions
- Compiled the diagram design
- Generated the UI component
I have designed the architecture delta for your Auth migration. I selected the
Architecture Delta visual type to highlight the decommissioning of the monolith and the introduction of the new Identity Provider (IdP) and Token Service.
Auth Migration Architecture Delta
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Auth Migration Delta</title>
<style>
:root { --paper: #1a1b1e; --ink: #e5e7eb; --accent: #3b82f6; --muted: #9ca3af; }
body { background: var(--paper); color: var(--ink); font-family: 'Geist Sans', sans-serif; }
.canvas { width: 100%; max-width: 800px; margin: 2rem auto; }
.delta-ledger { margin-top: 1rem; border-top: 1px solid var(--muted); padding-top: 1rem; }
</style>
</head>
<body>
<div class="canvas">
<h1>Auth Migration</h1>
<svg viewBox="0 0 800 400" role="img" aria-labelledby="auth-delta-title auth-delta-desc">
<title id="auth-delta-title">Auth Service Migration Delta</title>
<desc id="auth-delta-desc">Diagram showing the shift from a monolith to microservices.</desc>
<!-- SVG content with orthogonal arrows and node boxes -->
<rect x="50" y="50" width="120" height="60" rx="6" fill="none" stroke="#ef4444" stroke-dasharray="4" />
<text x="60" y="85" fill="#ef4444">Legacy Monolith</text>
<path d="M 170 80 L 300 80" stroke="#9ca3af" fill="none" marker-end="url(#arrow)" />
<rect x="300" y="50" width="120" height="60" rx="6" fill="#3b82f6" stroke="#3b82f6" />
<text x="310" y="85" fill="#ffffff">OAuth2 IdP</text>
</svg>
<div class="delta-ledger">
<h3>Changes</h3>
<ul>
<li><strong>Remove:</strong> Legacy Monolith Auth (internal)</li>
<li><strong>Add:</strong> OAuth2 Identity Provider (containerized)</li>
<li><strong>Add:</strong> JWT Validation Middleware</li>
</ul>
</div>
</div>
</body>
</html>
Next steps
- Review the delta-ledger to confirm all decommissioned components are listed.
- Run
python3 scripts/export_png.py auth-delta.htmlto generate a slide-ready image. - Customize the
accenttoken instyle-guide.mdif the blue brand color needs adjustment.
auth-delta.html
TSX · React component
Example file from a real run - the skill writes it into your workspace.
Connects securely to your tools. The creator never sees your data.
About this skill
Architecting technical systems is difficult, but explaining them shouldn't be. This skill replaces generic, cluttered AI-generated diagrams with editorial-grade schematics that follow professional design principles.
What it does
- Multi-type generation produces 45 specific visual layouts including architecture deltas, sequence diagrams, Wardley maps, and C4-style models.
- Semantic routing selects layout patterns based on behavioral triggers like bottlenecks, lifecycle phases, or trust boundaries.
- Design system enforcement applies a skinnable token system for colors and typography, ensuring diagrams match brand guidelines instead of looking like default "AI slop."
- Editorial pruning applies a strict complexity budget, limiting nodes and arrows to maintain high signal-to-noise ratios.
- Smart importing redrafts existing
.drawio, Mermaid, and.excalidrawfiles into the local design system while maintaining structural fidelity.
How it works
- Onboarding gate triggers on the first run to verify brand tokens or load a saved design profile.
- Strategy phase selects the visual type and semantic pattern based on the technical problem described.
- Drafting process generates a self-contained HTML file containing inline, accessible SVG markup.
- Validation check runs the output through a mandatory connector and layout gate to ensure orthogonal routing and legible spacing.
Frameworks & tools
This skill generates standalone HTML/SVG assets. It includes Python scripts for geometry verification and format export (PNG/SVG). It uses Geist and Instrument Serif typography via Google Fonts or system fallbacks.
Why this beats prompting it yourself
Generic prompts produce messy, inconsistent layouts with overlapping lines and poor color contrast. This skill enforces a 4px grid, strict orthogonal routing, and professional editorial standards that make diagrams board-ready without manual cleanup.
Use cases
- Architecture reviews showing structural changes between "current" and "future" states.
- Security modeling mapping trust boundaries and compensating controls.
- Process optimization identifying fan-in bottlenecks or queue depth in data pipelines.
- Executive reporting converting complex technical trees into simplified summary cards.
Known limitations
Limits diagrams to 9 nodes and 12 arrows to ensure readability. Exporting to PNG or SVG requires local Python scripts and is not automatic.
Strict budget of 9 nodes and 12 arrows per diagram. PNG/SVG export requires running local Python scripts. No support for JetBrains Mono.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 23 days ago
- Free with an Agensi account
Requires