excalidash-observability-flow

Generates left-to-right observability pipeline diagrams showing logs, metrics, and traces flowing to storage and alerting.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Drawing a clear observability architecture diagram by hand is slow and error-prone: signal pipelines get merged, alert and backpressure paths are forgotten, and credentials leak into exported runbooks. This Skill produces a validated, left-to-right telemetry data-flow diagram in Excalidraw via the ExcaliDash MCP server. ## Core Features & Use Cases - Three-signal fan-out: Renders instrumented services feeding a collector/agent that splits into separate metrics, logs, and traces pipelines, each landing in its own storage backend (e.g. Prometheus, Loki, Tempo) with dashed telemetry edges and a signal legend. - Four distinct paths: Separates the happy path from the alert path (rule → notifier → on-call), the error/backpressure path (buffer full → drop/spool → dead-letter), and the on-call escalation chain (primary → secondary → incident). - Mandatory quality loop: Runs lint, score, and repair cycles until the drawing scores at least 95 with zero hard blockers, with rollback to checkpoints if a repair lowers the score. - Secret redaction: Replaces ingest tokens, remote-write credentials, and webhook URLs with typed [REDACTED_*] placeholders before any tool call and re-scans the export. - Use Case: Ask for a diagram of your OpenTelemetry pipeline where services emit to the collector, which fans out metrics to Prometheus, logs to Loki, and traces to Tempo, all visualized in Grafana with alerting and on-call escalation. ## Quick Start Ask the AI to diagram your observability pipeline, naming your services, collector, storage backends, and alerting tool, for example: draw our OpenTelemetry flow from services through the collector to Prometheus, Loki, and Tempo with Grafana dashboards and PagerDuty alerts.

Frequently Asked Questions about excalidash-observability-flow

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

FAQPage Schema
How do I draw an OpenTelemetry pipeline diagram with AI?

Describe your services, collector, and storage backends in plain language and the skill generates a left-to-right flowchart via the ExcaliDash MCP create_diagram_from_prompt tool. It fans the collector into separate metrics, logs, and traces lanes with dashed telemetry edges and a legend.

How to diagram alerting and on-call escalation in an observability flow?

The skill draws the alert path as a separate branch starting from an alert rule evaluated over stored data, then routing through a notifier to on-call. Escalation is rendered as an ordered chain: primary, secondary, then incident.

Can the diagram show backpressure and dropped telemetry handling?

Yes, the error/backpressure path is a required branch. It starts at a decision node on the collector for a full buffer, routes through drop or spool-to-disk, and terminates in a dead-letter sink rather than looping back to a service.

Does the skill prevent secrets from leaking into exported diagrams?

Yes, ingest tokens, remote-write credentials, database URLs, and webhook URLs are replaced with typed [REDACTED_*] placeholders before any tool call. The exported SVG or PNG is re-scanned to confirm no live secret remains.

When should I not use the observability flow diagram skill?

Do not use it for application request/response flows, CI/CD or cloud deployment topology, security trust-boundary views, or single-service internal architecture. Those belong to the flowchart, devops-cloud-deployment, security, or C4 sibling skills.

What quality standard does the generated diagram have to meet?

The drawing must score at least 95 with zero hard blockers such as arrow-text intersections, frame title overlaps, or items outside frames. A mandatory lint, score, and repair loop runs until the threshold is met, with rollback if a repair lowers the score.