Skip to content
Back to skills

Architecture Diagram

ASecurity

Use when a design, plan, or option needs the person to see how a system works - what runs where, what is new or reused, and how one request moves through it. Draws inline-SVG system and flow diagrams in the house style, light and dark, from the bundled kit.

  • 9 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 10, 2026
ai-agentsaws

Works with

  • cli

Security analysis

A100/100

Pro scans all 3 files and shows the line behind each finding

Scanned November 10, 2026

npx -y skills add greenfield-inc/agent-farm --skill architecture-diagram --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Architecture Diagram?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Architecture Diagram
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/greenfield-inc-architecture-diagram/badge)](https://www.skillsdirectory.com/skills/greenfield-inc-architecture-diagram)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: architecture-diagram
description: Use when a design, plan, or option needs the person to see how a system works - what runs where, what is new or reused, and how one request moves through it. Draws inline-SVG system and flow diagrams in the house style, light and dark, from the bundled kit.
---

# Architecture diagram

The diagram answers "what runs where, and what happens to one request" before any prose. Draw it from the real code.

## Before drawing

- Read the code and deployment config for every part you show, including the process each runs in.
- Answer the reader's main question, such as "new server or existing one?", in the diagram.
- Mark every part existing, new, or external, and name new tables, tasks, services and deployments.

## The page

Write one self-contained HTML page following [references/layout.md](references/layout.md), copying tokens, classes and markers from [references/diagram-kit.html](references/diagram-kit.html). Sections, in order:

1. **Answer first:** 3 to 5 bullets on what runs where, what is new versus reused, and whether a new service is needed.
2. **System diagram:** components in their deployment frames, edges labelled with latency, cost or volume, and a legend.
3. **One flow per scenario:** happy path, main variants, abuse or failure, outage. Each is a numbered sequence diagram with matching numbered steps and a bold outcome.
4. **Behavior table** for staged systems: each stage on error and on a positive result, now and later.
5. **Arithmetic** for cost and latency, with assumptions labelled.

## Style

- Inline SVG with a `viewBox`, colours from CSS variables, text 11px or larger, each diagram wrapped in `.diag` so it scrolls sideways on phones.
- Five line styles, one meaning each: sync, new, async (dashed), external, alert.
- Up to about 12 boxes per diagram; split larger systems into several diagrams.
- Label arrows and number every flow step.
- Check the page in light and dark mode and fix collisions and clipped text before sharing.

Files in this skill

  • SKILL.md2 KB
  • references/diagram-kit.html9.2 KB
  • references/layout.md1.3 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.