All skills
cathrynlavery avatar

/diagram-design

@ea5019e

Create branded architecture, IT current-state, flowchart, sequence, state machine, ER/data model, timeline, swimlane, quadrant, radar/spider, polar chart (polar/radial lollipop), loop/flywheel, nested, tree, org chart, layer stack, Venn, pyramid/funnel, treemap, heatmap, bar, waterfall, line, Gantt and scatter charts, high-level, process, medallion, data flow, DP integration, DP security matrix, Sankey, fishbone, Wardley map, kanban, user journey, deployment, dependency graph, UML class, story map, or database schema diagrams as HTML/SVG/PNG, with .drawio and .excalidraw import support, plus lifecycle phase maps and onboarding guidance.

Use this Skill: https://skilld.dev/gh/cathrynlavery/diagram-design/diagram-design

This session only. Nothing lands on disk.

referencestype-pyramid.md

≈446 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Pyramid / Funnel

Best for: hierarchy of needs, prioritization ranks, value pyramids, conversion funnels, content importance stacks.

Two orientations — pick one

  • Pyramid (point up) — narrow apex = most important / rarest / most valuable. Base is broadest / foundational.
  • Funnel (point down) — narrow end = conversion (smallest group). Top is widest / audience.

Don't mix orientations on one diagram.

Layout conventions

  • 4–6 layers. Each layer is a trapezoid built from an SVG <polygon> with 4 points.
  • Consistent layer height (56–72px).
  • Widths decrease linearly from base to apex (pyramid) or top to bottom (funnel). When showing real funnel data, widths must be honest (proportional to count/percentage).
  • Each layer has:
    • Name label centered inside the trapezoid — Geist 12–14px 600.
    • Sublabel below or beside the name — Geist Mono 9–10px.
    • Side annotation (right or left) — optional. For funnels: drop-off percentage here (−40%).
  • Fill: subtle graded tints OR all paper-2 with hairline dividers (cleaner). Pick one.
  • Stroke: 1px hairline between layers; outer silhouette 1px muted or ink.
  • Coral on ONE layer only: apex of pyramid, conversion layer of funnel, or critical bottleneck.
  • Optional left-margin axis arrow + Geist Mono label (rarer ↑, drop-off ↓).

Anti-patterns

  • 7+ layers (illegible — compress or split).
  • Pyramid for non-hierarchical data (use a tree or bar chart).
  • Dishonest widths (fake equal spacing when drops are unequal).
  • Coral on the base layer (dilutes the "apex = rare" signal).

Examples

  • assets/example-pyramid.html — minimal light
  • assets/example-pyramid-dark.html — minimal dark
  • assets/example-pyramid-full.html — full editorial

Source: SKILL.md on GitHub

1 warning2d3 checks · Risk SAFE
  • Gen Agent Trust Hub2d

    This skill provides a comprehensive design system and toolset for creating branded diagrams as self-contained HTML/SVG files. It supports over 40 visual types and features robust mechanisms for importing diagrams from formats like Mermaid, draw.io, and Excalidraw, accompanied by automated validation scripts for design consistency.

  • Socket2d

    No alerts

  • Snyk2d

    Risk: MEDIUM · 1 issue

Signed by skilld at ea5019e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated 3 days ago
metadata
{
  "version": "2.6"
}

README badge

README badge for cathrynlavery/diagram-design