Skip to content

K-Dense-AI/scientific-agent-skills / skills/markdown-mermaid-writing

markdown-mermaid-writing

Unverified

Writes scientific Markdown documentation and Mermaid diagrams for workflows, relationships, timelines, and schemas. Provides syntax references, document templates, accessibility guidance, and version-aware rendering checks. Use when a user requests Markdown, Mermaid, or a text-based structural diagram; quantitative scientific figures require suitable plotting tools.

FileKindSize
SKILL.mdskill md16.3 KB
assets/examples/example-research-report.mdmarkdown3.4 KB
references/current-rendering.mdmarkdown7.6 KB
references/diagrams/architecture.mdmarkdown5.0 KB
references/diagrams/block.mdmarkdown5.0 KB
references/diagrams/c4.mdmarkdown6.7 KB
references/diagrams/class.mdmarkdown8.6 KB
references/diagrams/complex_examples.mdmarkdown16.8 KB
references/diagrams/er.mdmarkdown8.0 KB
references/diagrams/flowchart.mdmarkdown7.0 KB
references/diagrams/gantt.mdmarkdown6.0 KB
references/diagrams/git_graph.mdmarkdown2.2 KB
references/diagrams/kanban.mdmarkdown4.0 KB
references/diagrams/mindmap.mdmarkdown2.5 KB
references/diagrams/packet.mdmarkdown2.4 KB
references/diagrams/pie.mdmarkdown1.9 KB
references/diagrams/quadrant.mdmarkdown2.6 KB
references/diagrams/radar.mdmarkdown2.8 KB
references/diagrams/requirement.mdmarkdown3.0 KB
references/diagrams/sankey.mdmarkdown2.6 KB
references/diagrams/sequence.mdmarkdown5.9 KB
references/diagrams/state.mdmarkdown5.7 KB
references/diagrams/timeline.mdmarkdown4.5 KB
references/diagrams/treemap.mdmarkdown2.6 KB
references/diagrams/user_journey.mdmarkdown5.2 KB
references/diagrams/xy_chart.mdmarkdown2.6 KB
references/diagrams/zenuml.mdmarkdown2.5 KB
references/markdown_style_guide.mdmarkdown32.4 KB
references/mermaid_style_guide.mdmarkdown26.6 KB
templates/decision_record.mdmarkdown7.2 KB
templates/how_to_guide.mdmarkdown7.1 KB
templates/issue.mdmarkdown11.6 KB
templates/kanban.mdmarkdown10.6 KB
templates/presentation.mdmarkdown8.1 KB
templates/project_documentation.mdmarkdown11.5 KB
templates/pull_request.mdmarkdown11.8 KB
templates/research_paper.mdmarkdown10.1 KB
templates/status_report.mdmarkdown7.2 KB

assets/examples/example-research-report.md

View on GitHub
# Synthetic Assay Quality-Control Report

_Format example only — every sample count and date below is invented. No experiment,
statistical inference, or scientific software execution is reported._

---

## 📋 Scope

This example shows how a Markdown report can preserve a workflow, exact counts,
and an accessible chart. It does not recommend an assay protocol or biological
threshold. In a real report, specify the measurement method, prespecified exclusion
criteria, unit of replication, data location, and software versions.

## 🔄 Workflow

The diagram separates failed quality checks from the samples retained for analysis.
An arrow means a processing step, not a causal biological relationship.

```mermaid
flowchart LR
    accTitle: Synthetic Sample Quality Control
    accDescr: Twelve fictional samples enter quality checks. Ten pass and enter a descriptive summary; two fail and remain in the exclusion record.
    received["Received: 12 samples"] --> qc{"Quality check"}
    qc -->|"Pass: 10"| retained["Retained for summary"]
    qc -->|"Fail: 2"| excluded["Record exclusion reason"]
    retained --> report["Report counts and limitations"]
    excluded --> report
```

## 📊 Illustrative results

Counts are deliberately small enough to audit: each batch has four received samples;
passed plus failed equals received. The overall pass fraction is 10/12 (83.3%),
a description of these invented counts rather than an estimate of assay performance.

| Fictional batch | Received | Passed | Failed |
| --- | ---: | ---: | ---: |
| A | 4 | 4 | 0 |
| B | 4 | 3 | 1 |
| C | 4 | 3 | 1 |
| Total | 12 | 10 | 2 |

_The chart shows passed sample counts, with a common zero-based count axis. The table
above supplies every value independently of color or screen-reader SVG support._

```mermaid
xychart-beta
    accTitle: Fictional Passed Sample Counts
    accDescr: Batch A has four passed samples; batches B and C each have three. All batches started with four samples.
    title "Synthetic Passed Sample Counts"
    x-axis ["A", "B", "C"]
    y-axis "Sample count" 0 --> 4
    bar "Passed" [4, 3, 3]
```

## 📅 Illustrative chronology

_The fictional workflow records planning, quality review, and reporting in order.
Timeline spacing is categorical; it does not encode elapsed durations._

```mermaid
timeline
    title Synthetic Review Milestones
    2026-09-28 : Define example criteria
    2026-09-29 : Review 12 fictional samples
    2026-09-30 : Report retained and excluded counts
```

## 🔍 Interpretation and limits

These figures demonstrate Markdown/Mermaid formatting. They provide no evidence of
biological efficacy, group differences, causality, or reproducibility of an assay.
For a real analysis, retain raw observations and plot uncertainty using appropriate
scientific software; do not manufacture a significance test from this count table.

<details>
<summary>Record to add for a real analysis</summary>

- Dataset identifier, version, and access date.
- Unit of replication and prespecified quality criteria.
- A reason for each excluded sample, with identifiers that respect privacy.
- Analysis code, environment versions, and source data for every quantitative figure.

</details>

---

## 🔗 Rendering reference

The syntax follows [official Mermaid XY chart documentation](https://mermaid.js.org/syntax/xyChart.html).
The named bar legend requires Mermaid 11.17.0+; all three diagrams rendered locally
with Mermaid 12.0.0. Check the intended destination separately.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall