Markdown Report Writing
Guide AI agents to write beautifully formatted, well-illustrated Markdown reports with proper structure, diagrams, and compatibility across GitHub and Obsidian. Use this skill whenever the user asks you to write a report, project documentation, experiment report, README, technical document, or any long-form Markdown content. Also trigger when users mention Markdown formatting, Mermaid diagrams, report templates, or document publishing.
Install
/plugin marketplace add NeuroAIHub/awesome_cognitive_and_neuroscience_skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add NeuroAIHub/awesome_cognitive_and_neuroscience_skills --skill markdown-report-writinggit clone --depth 1 https://github.com/NeuroAIHub/awesome_cognitive_and_neuroscience_skills.git /tmp/awesome_cognitive_and_neuroscience_skills
mkdir -p ~/.claude/skills
cp -r /tmp/awesome_cognitive_and_neuroscience_skills/skills/markdown-report-writing ~/.claude/skills/markdown-report-writingPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Markdown Report Writing Provide expert guidance for writing professional, visually polished Markdown reports that render correctly on both GitHub and Obsidian. ## Core Philosophy: Three-Layer Writing Model When writing any Markdown report, think in three layers: 1. **Content layer** — Use CommonMark / GFM + Obsidian shared syntax for all headings, paragraphs, lists, images, tables, code blocks, footnotes, task lists, math ($\LaTeX$), and Mermaid diagrams. This is your foundation. 2. **Enhancement layer** — Add renderer-specific features only when necessary: GitHub `<details>` folding, relative links; Obsidian `[[wikilink]]`, `![[embed]]`, Callout, `cssclasses`. 3. **Build layer** — For complex layouts, table of contents generation, site styling, and slide exports, delegate to Pandoc / Quarto / MkDocs / GitHub Pages. This ensures your output is readable, portable, automatable, and version-controllable across all target environments. ## Writing Principles Follow these rules for every report: 1. **Shared syntax first** — Build the body with syntax that works on both GitHub and Obsidian (headings, links, images, tables, code blocks, footnotes, task lists, Mermaid, math). 2. **Relative paths for all assets** — Place images, diagrams, and attachments in `assets/` and reference them with relative paths. 3. **Enhance per target** — After the core is solid, add renderer-specific enhancements: - **GitHub**: relative links, section anchors, `<details>`, Mermaid
Details
- Skill name
markdown-report-writing- Path
skills/markdown-report-writing/SKILL.md- License
- MIT
- Repo updated
- 13 July 2026
FAQ
What does the Markdown Report Writing skill do?
Guide AI agents to write beautifully formatted, well-illustrated Markdown reports with proper structure, diagrams, and compatibility across GitHub and Obsidian. Use this skill whenever the user asks you to write a report, project documentation, experiment report, README, technical document, or any long-form Markdown content. Also trigger when users mention Markdown formatting, Mermaid diagrams, report templates, or document publishing.
How do I install the Markdown Report Writing skill?
Claude Code plugin: /plugin marketplace add NeuroAIHub/awesome_cognitive_and_neuroscience_skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Markdown Report Writing popular?
It lives in NeuroAIHub/awesome_cognitive_and_neuroscience_skills, which has 43 GitHub stars and 6 forks.
Related skills
Act R Model Builder
43NeuroAIHub/awesome_cognitive_and_neuroscience_skills
Guides ACT-R cognitive model construction: chunk types, production rules, subsymbolic parameters, and model validation
Alternative Uses Task Designer
43NeuroAIHub/awesome_cognitive_and_neuroscience_skills
Domain-validated guidance for designing Alternative Uses Task (AUT) experiments measuring divergent thinking, with parameters for AI-augmented and traditional conditions
Bayesian Cognitive Model Builder
43NeuroAIHub/awesome_cognitive_and_neuroscience_skills
Domain-validated guidance for building hierarchical Bayesian cognitive models with Stan/PyMC: prior specification, model structure, MCMC diagnostics, and posterior predictive checks
Unity Async Patterns
40Nice-Wolf-Studio/unity-claude-skills
Unity async and coroutine correctness patterns. Catches common mistakes with Awaitable double-await, missing cancellation tokens, thread context after BackgroundThreadAsync, coroutine error swallowing, batch mode WaitForEndOfFrame, and Addressables handle leaks. PATTERN format: WHEN/WRONG/RIGHT/GOTCHA. Based on Unity 6.3 LTS documentation.
Write a Skill
57javimosch/supercli
Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
Unity Cinemachine
40Nice-Wolf-Studio/unity-claude-skills
Unity 6 Cinemachine camera system guide. Use when working with virtual cameras, camera blending, follow cameras, FreeLook, camera shake, or state-driven cameras. Covers Cinemachine 3.x API. Based on Unity 6.3 LTS documentation.
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.