Skip to content
cccskills
FreePublished on GitHub

mermaid-diagrams

Author Mermaid diagrams inside ```mermaid fenced code blocks in markdown files (README, AGENTS.md, PR descriptions, chat responses). Covers every stable, non-experimental diagram type: flowchart, sequence, class, state, entity relationship, user journey, Gantt, pie, quadrant, requirement, gitGraph, block, packet, kanban, XY chart, event modeling. Use when: picking a diagram type; writing correct fence syntax; documenting architecture, processes, timelines, schemas, or data relationships compactly for humans and agents alike, since a diagram conveys structure in far fewer tokens than prose. DO NOT USE FOR: the Mermaid Live Editor or mermaid.ai chat (fence syntax only); experimental or beta diagrams (swimlanes, mindmap, timeline, sankey, architecture, radar, treemap, venn, ishikawa, wardley, cynefin, treeView, ZenUML, C4); general Markdown formatting (use markdown-best-practices).

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36 stars(GitHub 36 + cccskills 0)

Run score Not tested

See how to install

Files included (5)

  • SKILL.md4.6 KB
  • references/charts-and-comparison.md2.5 KB
  • references/planning-and-tracking.md2.5 KB
  • references/process-and-time.md2.9 KB
  • references/structure-and-data.md3.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Mermaid Diagrams

Mermaid diagrams render natively in GitHub, VS Code, and Copilot Chat markdown from a plain ```mermaid fenced code block — no image files, no external tools. For an agent, a diagram is also a token-efficient way to convey structure: a 10-line flowchart replaces a paragraph of prose while staying unambiguous for both the human reader and the next agent that reads the file.

Every diagram in this skill is stable in current Mermaid — none require the -beta suffix keyword or carry an "experimental/may evolve" warning in the official docs. Experimental diagram types are deliberately excluded (see frontmatter).

Anatomy

FilePurpose
SKILL.mdDecision table, fence basics, reference index
references/structure-and-data.mdFlowchart, Class, State, Entity Relationship, Block
references/process-and-time.mdSequence, GitGraph, Event Modeling, User Journey
references/planning-and-tracking.mdGantt, Kanban, Requirement
references/charts-and-comparison.mdPie, Quadrant, XY Chart, Packet

Fence Basics

```mermaid
flowchart LR
    A --> B
```

The first line inside the fence is always the diagram's keyword (flowchart, sequenceDiagram, classDiagram, ...) — this is what selects the diagram type; everything else is that diagram's own syntax.

This skill only covers syntax inside the fence — run markdown-best-practices over the surrounding file (blank lines around the fence, heading/list hygiene) before treating the edit as finished.

Which Diagram? (Quick Reference)

DiagramKeywordUse When
Flowchartflowchart / graphShow branching logic, a process, or a decision tree
SequencesequenceDiagramShow ordered messages/calls between actors or systems over time
ClassclassDiagramModel OOP classes: attributes, methods, and relationships
StatestateDiagram-v2Model the states of one entity and its transitions
Entity RelationshiperDiagramModel database entities and their relationships/cardinality
User JourneyjourneyShow a user's steps and satisfaction across a task
GanttganttShow a project schedule: task durations and dependencies over calendar time
PiepieShow proportions of a whole across categories
QuadrantquadrantChartPlot items on two axes to prioritize or categorize them
RequirementrequirementDiagramTrace SysML-style requirements to the elements that satisfy/verify them
GitGraphgitGraphVisualize a branch/commit/merge history
BlockblockFreeform architecture/system diagram needing manual layout control
PacketpacketShow the byte/bit layout of a network packet or binary format
KanbankanbanShow a task board with columns (Todo/In Progress/Done)
XY ChartxychartPlot numeric bar/line data across two axes
Event ModelingeventmodelingShow a UI → Command → Event timeline for an event-sourced system

Reference Files

FileLoad When
references/structure-and-data.mdDocumenting code structure, a data model, or a component layout
references/process-and-time.mdDocumenting an interaction, a history, or a flow over time
references/planning-and-tracking.mdDocumenting a schedule, a task board, or formal requirements
references/charts-and-comparison.mdDocumenting proportions, prioritization, numeric series, or packet layout

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

3d-rotation-theory

Free

Abstract math for 3D rotation representations and conversions. USE FOR: understanding axis-angle representation; Euler angles (yaw/pitch/roll, convention choices); rotation matrices (SO(3)); quaternion-based rotation; converting between representations; identifying and avoiding gimbal lock; composing rotations; half-angle formula; right-hand rule. DO NOT USE FOR: quaternion arithmetic details (use quaternion-algebra); slerp/lerp interpolation (use interpolation-on-manifolds); coordinate system definitions (use coordinate-system-conversions).

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

agent-graph-orchestration

Free

Design and scaffold multi-agent squads/swarms using the graph orchestration pattern (nodes = agents, edges = dependencies/data flow). USE FOR: designing a coordination topology for a multi-agent squad (sequential pipeline, parallel fan-out/aggregation, branching, feedback loop, cyclic); building an orchestrator agent that delegates to specialist agents; setting up an adversarial/tribunal code or document review with independent reviewers; scaffolding a squad's agent files for a target coding-agent harness (e.g. Copilot CLI or Claude Code custom agents). DO NOT USE FOR: authoring a single agent's frontmatter/prompt body (use copilot-cli-custom-agents, claude-code-custom-agents, or the target harness's own skill); SKILL.md authoring (use create-skill); ad-hoc multi-agent chat with no explicit topology.

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

agent-harness-logs

Free

Find, inspect, query, redact, and troubleshoot logs, transcripts, sessions, and OpenTelemetry data from coding-agent harnesses on Windows, macOS, Linux, and WSL. USE FOR: GitHub Copilot in VS Code; Copilot CLI; Claude Code; OpenAI Codex; Gemini CLI; OpenCode; Cursor, Windsurf, Kiro, or other VS Code-family editors; locating log files; diagnosing tool or model failures; correlating turns, subagents, and tool calls; querying JSONL, plaintext, or SQLite without spending model tokens; preparing sanitized diagnostics. DO NOT USE FOR: application logs unrelated to coding agents; uploading raw logs; treating unstable transcript schemas as public APIs.

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

agents-md

Free

Author and maintain AGENTS.md files — the open, tool-agnostic format for giving coding agents project context. Use when: creating AGENTS.md; writing an agent instructions file; root or nested AGENTS.md for monorepos; migrating CLAUDE.md, AGENT.md, .cursor/rules, or copilot-instructions.md to AGENTS.md; greenfield project setup before code exists; brownfield onboarding for an existing codebase; documenting build/test/lint commands, code style, PR/commit conventions, and security considerations for agents; AGENTS.md discovery and precedence rules. Works for any language, framework, or project size. DO NOT USE FOR: authoring SKILL.md skill files (use create-skill); APM package/plugin authoring (use apm-producer); language-specific style rules (use language skills e.g. csharp-best-practices).

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

angles-and-circular-arithmetic

Free

Abstract math for angle measurement, unit systems, and circular arithmetic. USE FOR: implementing angle types; converting between degrees/radians/gradians/revolutions; reducing angles to canonical range [0, Full); computing reference angles and quadrants; implementing safe modular arithmetic with negative inputs; angle addition and subtraction; classifying angles by sign and size. DO NOT USE FOR: trigonometric functions (use trigonometric-functions); coordinate conversions (use coordinate-system-conversions); interpolation (use interpolation-on-manifolds).

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

claude-code-custom-agents

Free

Create and maintain Claude Code custom subagents (.claude/agents/*.md files). USE FOR: authoring project (.claude/agents/) or user (~/.claude/agents/) subagent files; frontmatter fields (name, description, tools, disallowedTools, model, permissionMode, maxTurns, skills, mcpServers, hooks, memory, background, effort, isolation, color, initialPrompt); writing descriptions that drive automatic delegation and 'use proactively' phrasing; invoking subagents via natural language, @-mention, session-wide --agent, or the Agent tool; restricting which subagent types a coordinator can spawn with Agent(name1, name2); nested subagents and depth limits; built-in subagents (Explore, Plan, general-purpose, claude); troubleshooting a subagent that won't load or isn't invoked. DO NOT USE FOR: GitHub Copilot CLI custom agents (use copilot-cli-custom-agents); agent teams/teammates (a different, session-spanning feature); MCP server authoring; SKILL.md authoring (use create-skill).

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

See all skills by NetFabric

Report a problem with this skill