Skills design-doc-mermaid

📦

design-doc-mermaid

Name: design-doc-mermaid
Author: spillwavesolutions

Content revision r1 Safe 🌐 Network access📁 Filesystem access🔑 Env variables⚙️ External commands⚡ Contains scripts

Create Mermaid Diagrams and Design Documents

Complex systems are difficult to explain consistently. This skill creates structured Mermaid diagrams and design documents from requirements, source code, and configuration.

Supports: Claude Codex Code(CC)

📊 76 Adequate

Stop for confirmation before installing.

Review the plan and obtain explicit user consent before changing files.

Install with my Agent

Copy this request to your Agent. It includes the canonical Skill page and manifest.

Agent request

Review the Skillstore skill "design-doc-mermaid" from https://skillstore.io/skills/spillwavesolutions-design-doc-mermaid.md and its manifest at https://skillstore.io/api/skills/spillwavesolutions-design-doc-mermaid/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

Your Agent should still show its plan and request any confirmation required by the security policy.

Agent-readable resources

Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.

Markdown detail GET /skills/spillwavesolutions-design-doc-mermaid.md Signed manifest GET /api/skills/spillwavesolutions-design-doc-mermaid/manifest Signed lockfile GET /api/skills/spillwavesolutions-design-doc-mermaid/lockfile

Test it

Using "design-doc-mermaid". Show the checkout process with payment failure and retry paths.

Expected outcome:

A high-contrast activity diagram showing cart review, validation, payment authorization, retry limits, order creation, and failure outcomes.

Using "design-doc-mermaid". Document the login request across the browser, API, identity service, and database.

Expected outcome:

A sequence diagram showing credential submission, validation, user lookup, token creation, success responses, and authentication errors.

Using "design-doc-mermaid". Create an API design document for a contact management service.

Expected outcome:

A structured design document covering scope, endpoints, authentication, data entities, errors, deployment, decisions, and supporting Mermaid diagrams.

Security Audit

Safe

v1 • 8/25/2026 Open versioned report

All 400 presented static findings are contextual false positives from documentation, examples, or constrained local rendering utilities. The Python utilities invoke fixed mmdc commands with argument arrays and no shell. No prompt injection, data exfiltration intent, or malicious logic was found. Static review was capped at 400/901 representative findings; omitted static matches are unconfirmed, so automatic publishing stays disabled until manual review.

Files scanned

16,491

Lines analyzed

Review items

False positives ignored

Risk Factors

🌐 Network access (48)

📁 Filesystem access (50)

🔑 Env variables (12)

examples/fastapi/README.md:532 examples/fastapi/README.md:536 examples/fastapi/README.md:564 examples/fastapi/README.md:569 examples/fastapi/README.md:622 examples/fastapi/README.md:410 examples/fastapi/README.md:540 examples/fastapi/README.md:574 examples/node-webapp/README.md:476 examples/node-webapp/README.md:656 examples/node-webapp/README.md:476 examples/node-webapp/README.md:656

⚙️ External commands (50)

examples/node-webapp/README.md:291-309 examples/node-webapp/README.md:558-568 examples/node-webapp/README.md:568-577 examples/node-webapp/README.md:577-583 examples/node-webapp/README.md:667-671 examples/node-webapp/README.md:671-673 scripts/extract_mermaid.py:165 scripts/extract_mermaid.py:212 scripts/extract_mermaid.py:65 scripts/mermaid_to_image.py:103 scripts/mermaid_to_image.py:214 scripts/resilient_diagram.py:413 scripts/resilient_diagram.py:441 scripts/resilient_diagram.py:126 scripts/resilient_diagram.py:184-187 scripts/resilient_diagram.py:187-192 scripts/resilient_diagram.py:192-194 scripts/resilient_diagram.py:667-669 SKILL.md:38-75 SKILL.md:75-79 SKILL.md:79-83 SKILL.md:83-84 SKILL.md:84-85 SKILL.md:85-86 SKILL.md:86-87 SKILL.md:87-89 SKILL.md:89 SKILL.md:95-96 SKILL.md:96-97 SKILL.md:97-98 SKILL.md:98-99 SKILL.md:99-100 SKILL.md:100-101 SKILL.md:101-107 SKILL.md:107-108 SKILL.md:108-109 SKILL.md:109-110 SKILL.md:110-111 SKILL.md:111-115 SKILL.md:115-127 SKILL.md:127-131 SKILL.md:131-132 SKILL.md:132-133 SKILL.md:133-138 SKILL.md:138-143 SKILL.md:143-144 SKILL.md:144 SKILL.md:157-158 SKILL.md:158-164 SKILL.md:164-168

⚡ Contains scripts (2)

examples/react/README.md:571 examples/react/README.md:572

No confirmed security findings were detected by the latest completed static and semantic audit. This does not prove the skill has no side effects.

Audited by: codex

Share & cite this report

Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.

Open versioned report

Copy report link

https://skillstore.io/skills/spillwavesolutions-design-doc-mermaid/audits/1?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown badge

[![Skillstore security assessment](https://skillstore.io/badges/skills/spillwavesolutions-design-doc-mermaid/security.svg)](https://skillstore.io/skills/spillwavesolutions-design-doc-mermaid?utm_source=security_passport_badge)

HTML badge

<a href="https://skillstore.io/skills/spillwavesolutions-design-doc-mermaid?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/spillwavesolutions-design-doc-mermaid/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Embed card

<iframe src="https://skillstore.io/embed/skills/spillwavesolutions-design-doc-mermaid.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

Academic citations (APA · BibTeX · CFF)

APA citation

spillwavesolutions. (2026). design-doc-mermaid security audit report (audit version 1) [Author version unspecified]. Skillstore. https://skillstore.io/skills/spillwavesolutions-design-doc-mermaid/audits/1

BibTeX citation

@techreport{spillwavesolutions-spillwavesolutions-design-doc-mermaid-2026,
  author = {spillwavesolutions},
  title = {design-doc-mermaid security audit report (audit version 1)},
  institution = {Skillstore},
  year = {2026},
  number = {1},
  url = {https://skillstore.io/skills/spillwavesolutions-design-doc-mermaid/audits/1},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "design-doc-mermaid security audit report (audit version 1)"
version: "unspecified"
type: report
authors:
  - name: "spillwavesolutions"
date-released: "2026-08-25"
url: "https://skillstore.io/skills/spillwavesolutions-design-doc-mermaid/audits/1"
identifiers:
  - type: other
    value: "skillstore:spillwavesolutions-design-doc-mermaid:audit:1"
    description: "Skillstore immutable audit report identifier"

Skillstore Score

Why this score Evidence Confidence: Medium

100

Architecture

Maintainability

Content

Community

Spec Compliance

What You Can Build

Document System Architecture

Create architecture and deployment views from system requirements, service boundaries, and infrastructure details.

Visualize Application Code

Translate framework structure, request flows, data models, and business logic into focused Mermaid diagrams.

Prepare Technical Design Documents

Build consistent API, feature, database, or system documents with diagrams ready for team review.

Try These Prompts

Create a Basic Flowchart

Create a Mermaid flowchart for [process]. Include the start, main decisions, success path, and failure path.

Diagram a Service Interaction

Create a Mermaid sequence diagram for [request]. Show [actors], important calls, responses, errors, and asynchronous steps.

Convert a Codebase to Diagrams

Analyze [repository or files]. Create separate Mermaid diagrams for architecture, runtime flow, data model, and deployment. State assumptions and exclude unsupported details.

Produce a Complete Design Document

Create a [system, API, feature, or database] design document for [project]. Include scope, requirements, decisions, risks, alternatives, and validated Mermaid diagrams.

Best Practices

Keep each diagram focused on one concept and label assumptions outside the diagram.
Validate Mermaid syntax before publishing or converting diagrams to images.
Load only the guides and framework examples relevant to the requested output.

Avoid

Do not combine architecture, deployment, data, and runtime behavior in one crowded diagram.
Do not present inferred implementation details as confirmed facts from the codebase.
Do not rely on Mermaid fences alone when the target platform requires rendered images.