K-Dense-AI/scientific-agent-skills / skills/markdown-mermaid-writing
markdown-mermaid-writing
UnverifiedWrites 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.
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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |