Agent Skill

/visualcave
Technical Diagrams

Generate interactive, publication-quality technical diagrams as standalone HTML files — or embed as Astro / React components. Mermaid-based or full custom canvas. Dark mode, theme selector, step-through reveal, and SVG/PNG/PDF export built in.

/visualcave describe your diagram
GitHub · 28 examples · 16 diagram types
Capabilities Mermaid — 16 diagram types CSS flow animation Canvas animation Astro / React component output Step-through reveal SVG / PNG / PDF export
Astro / React Component Output — this mode generates .astro or .tsx files for embedding diagrams into blog posts and articles with full dark/light token alignment. It does not produce standalone HTML previews. See references/astro-component.md for the component template and token tables.
Architecture & Flow
graph TD

Transformer Architecture

Complete encoder-decoder stack with step-through guide and cross-attention bridge.

step-throughdark modegraph TD
/visualcave transformer architecture step-through, encoder decoder, multi-head attention
sequenceDiagram

OAuth 2.0 Authorization Code Flow

Full sequence across User, Client App, Auth Server, and Resource Server.

sequencesecurity
/visualcave OAuth 2.0 authorization code flow, sequence diagram
pipeline

Ecommerce Order Fulfillment

From checkout to delivery notification — order, warehouse, shipping stages.

custom CSSpipelineecommerce
/visualcave ecommerce order fulfillment, custom CSS pipeline layout
architecture

API Gateway Architecture

Gateway routing, auth, rate limiting, and microservice fan-out in a single view.

architectureAPI
/visualcave API gateway architecture, microservices, auth, rate limiting
pipeline

CI/CD Pipeline

End-to-end build, test, and deploy pipeline with environment promotion gates.

pipelineDevOps
/visualcave CI/CD pipeline, build test deploy, environment promotion gates
graph TD

API Lifecycle

Design, build, test, deploy, and deprecation stages of a REST API end to end.

graph TDAPI
/visualcave API lifecycle graph, design to deprecation
graph TD

RAG Pipeline

Document ingestion, vector search, reranking, and LLM generation in one view.

graph TDAIsearch
/visualcave RAG pipeline, vector DB, query embedding, retrieval augmented generation
graph TD

Kubernetes Deployment

Git push to running pods — image registry, API server, scheduler, HPA, and ingress.

graph TDk8sDevOps
/visualcave Kubernetes deployment, pods, HPA, ingress, control plane
graph LR

Event-Driven Microservices

Producers, Kafka topics, and consumers — decoupled services at scale.

graph LRKafkamicroservices
/visualcave event-driven microservices, Kafka topics, producers consumers
graph TD

Multi-Region Failover

Active-passive with health monitoring, DB replication, and automatic DNS rerouting.

graph TDreliabilityinfra
/visualcave multi-region failover, active-passive, health monitoring, DNS reroute
C4Context

Internet Banking — System Context

C4 Level 1: customer, banking platform, and the external systems around it.

C4context
/visualcave C4 system context for an internet banking platform
architecture-beta

Web App Infrastructure

CDN, API server, Postgres, and object storage with grouped cloud services.

architecturecloud
/visualcave cloud architecture, CDN, API, Postgres, object storage
Object & Data Models
classDiagram

E-Commerce Domain Model

User, Order, Product, Payment, Category, Address — with methods and multiplicity.

classDiagramUML
/visualcave class diagram, User Order Product Payment relationships
erDiagram

Blog Platform Schema

7-table schema with PK, FK, UK annotations and self-referential comments.

erDiagramdatabase
/visualcave ER diagram, ecommerce database schema
stateDiagram-v2

Order Lifecycle State Machine

All order states from Pending to Refunded, color-coded by status category.

stateDiagram-v2lifecycle
/visualcave state machine, order lifecycle, pending shipped delivered cancelled
Planning & Analysis
quadrantChart

Feature Priority Matrix

Q3 roadmap features plotted by effort vs impact across four quadrants.

quadrantChartroadmap
/visualcave quadrant chart, effort vs impact feature prioritization
pie

API Traffic Distribution

Request volume breakdown across 8 microservices over 30 days.

piemetrics
/visualcave pie chart, cloud infrastructure cost breakdown
gantt

Release Sprint Plan

Six-week delivery schedule across design, build, QA, and launch phases.

ganttschedule
/visualcave gantt chart, six week release plan with milestones
xychart-beta

Monthly Active Users

Bar + line combo tracking user growth against revenue, January to June.

xychartmetrics
/visualcave bar and line chart, MAU vs revenue by month
sankey-beta

Data Center Energy Flow

Where the power goes — grid and solar through servers, cooling, and losses.

sankeyflow
/visualcave sankey diagram, data center energy distribution
kanban

Sprint Board

Current sprint grouped by workflow state with assignee and priority metadata.

kanbansprint
/visualcave kanban board for the current sprint
Knowledge & History
timeline

Evolution of the Web

Web 1.0 to the AI era — major milestones from 1991 to 2024.

timelinehistory
/visualcave timeline, evolution of the web, 1991 to 2024
mindmap

System Design Topics

Core concepts for senior engineering interviews — scalability, storage, caching, observability.

mindmapsystem design
/visualcave mind map, system design topics, scalability caching observability
gitGraph

GitFlow Branching Strategy

Feature branches, release cuts, hotfixes, and version tags from v1.0.0 to v2.0.0.

gitGraphworkflow
/visualcave git graph, gitflow branching, feature release hotfix tags
Custom CSS — Rich Layouts
custom CSS

AI Evolution — 2017 to Present

Transformer to MCP — color-coded era cards, glowing milestone dots, hover lift. Shows what Mermaid timeline cannot.

custom CSStimelineAI history
/visualcave AI evolution timeline, rich CSS, color-coded by era, spine + dots + cards
custom CSS

LLM Training Pipeline

Pretraining → SFT → RLHF → deployment. Phase badges, numbered step circles, technique tags, output artifacts.

custom CSSpipelineLLM
/visualcave LLM training pipeline, rich CSS, phase badges, pretraining fine-tuning RLHF
custom CSS

Transformer Animated

CSS-animated Transformer architecture — flowing edges and node glow highlight attention and data paths in motion.

custom CSSanimatedAI
/visualcave transformer architecture, CSS flow animation, flowing edges, node glow
multi-diagram

The Agentic Horizon

A consequence map of the philosophical and economic shift from human-run software to a fully agentic civilization.

multi-diagramAIcanvas
/visualcave consequence map, agentic AI evolution, economic rupture forks, workforce transformation
Diagram Type Reference
When the user says… Use Best for
flow, pipeline, architecture, data flowgraph TDSystem overviews, decision trees
sequence, API calls, who calls whosequenceDiagramProtocol flows, auth, microservice calls
class, domain model, OOP, UMLclassDiagramObject relationships, API shape
state, lifecycle, status transitionsstateDiagram-v2Order states, auth sessions, FSMs
database, schema, tables, ERerDiagramDB design, ORM models
priority, 2×2, effort vs impactquadrantChartRoadmap prioritisation
timeline, history, milestonestimelineProduct history, roadmap dates
mind map, brainstorm, concept mapmindmapTopic overviews, study guides
git, branching, gitflow, commitsgitGraphBranch strategy, release process
pie chart, distribution, percentagepieTraffic split, budget breakdown
schedule, project plan, sprintganttProject timelines
bar chart, line chart, trend over timexychart-betaMetrics, growth curves
flow quantities, energy/traffic/money splitsankey-betaResource distribution
system context, C4, external systemsC4ContextHigh-level architecture docs
cloud infrastructure, services + connectionsarchitecture-betaDeployment diagrams
kanban board, sprint tasks, columnskanbanWork-in-progress boards