skills.rest
SatoryKono
SatoryKonoCOMMUNITY
Explore all skills by this author →
GitHub

technical-designer-mermaid

Creates and refines Mermaid diagrams for architecture, data flows, and domain models.

1|Updated Dec 1, 2025
Search Tags:#architecture#linting#mermaid#diagram#data-flow#bioetl#adr-040
One-click install
npx skills add https://github.com/SatoryKono/BioactivityDataAcquisition --skill technical-designer-mermaid
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: technical-designer-mermaid
Source: https://github.com/SatoryKono/BioactivityDataAcquisition/tree/main/docs/skills/local/technical-designer-mermaid
Command: npx skills add https://github.com/SatoryKono/BioactivityDataAcquisition --skill technical-designer-mermaid

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Create, refine, and review Mermaid diagrams for architecture, data flows, API interactions, and domain models with a focus on clarity, maintainability, and ADR-040 alignment within BioETL projects.

Core Features & Use Cases

  • Generic Mermaid mode for standalone diagrams across any repository.
  • BioETL project mode for diagrams tied to repository conventions, ADR-040 compliance, and rendering workflows.
  • Mode selection guidance, file-organization rules, and a metadata contract to ensure consistent diagrams across teams.

Quick Start

Provide a diagram prompt and select the mode (generic or BioETL) to generate or adjust a Mermaid diagram.

Frequently Asked Questions about technical-designer-mermaid

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

FAQPage Schema
How do I create Mermaid diagrams for architecture and data flows?▼

Mermaid diagrams for architecture and data flows are created by providing a diagram prompt and selecting a generic or BioETL project mode, which applies a technical-design mindset to ensure clarity and maintainability for domain models and API interactions.

How does ADR-040 compliance work for Mermaid diagrams in BioETL?▼

ADR-040 compliance for Mermaid diagrams in BioETL is enforced through repository conventions, ensuring canonical file placement, metadata headers, linting workflows, and version-controlled diagram assets are satisfied during project mode generation.

Can I use this to generate standalone Mermaid diagrams outside of a specific project?▼

Yes, you can generate standalone Mermaid diagrams across any repository using the generic mode. This allows you to create and refine architecture and domain model visuals independently of BioETL repository conventions.

What is the best way to organize and lint Mermaid files in a version-controlled repository?▼

Organizing and linting Mermaid files is best achieved by following repository conventions that enforce canonical file placement and metadata headers, satisfying requirements for linting workflows and rendering version-controlled diagram assets.

Do I need to follow specific metadata contracts when designing Mermaid diagrams for teams?▼

Yes, designing Mermaid diagrams for teams requires following a metadata contract to ensure consistent visuals across teams. This contract governs file-organization rules and mode selection guidance for maintaining architecture and data flow diagrams.

Related Skills

Explore More Design & Creative Skills→
SSiertsemaSSiertsema

context-diagramming

Create Mermaid-compatible system context diagrams with labeled data flows.

Community
Intermediate
wsxwj123wsxwj123
7

markdown-mermaid-writing

Consolidate Markdown documentation with Mermaid diagrams as the canonical format.

Community
Advanced
yu-iskwyu-iskw
3

manage-adr

Initialize, create, supersede, link, and report Architecture Decision Records with Mermaid diagrams.

Community
Intermediate
jiaxiaojunQAQjiaxiaojunQAQ
75

architecture-diagram-creator

Generate architecture diagrams from natural language prompts.

Community
Intermediate