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.

43 stars 6 forksWriting & Content Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add NeuroAIHub/awesome_cognitive_and_neuroscience_skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add NeuroAIHub/awesome_cognitive_and_neuroscience_skills --skill markdown-report-writing
Manual install
git 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-writing

Personal 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
Read the full skill on GitHub

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

43

NeuroAIHub/awesome_cognitive_and_neuroscience_skills

Guides ACT-R cognitive model construction: chunk types, production rules, subsymbolic parameters, and model validation

AI, LLMs & Agents

Alternative Uses Task Designer

43

NeuroAIHub/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

Productivity & Notes

Bayesian Cognitive Model Builder

43

NeuroAIHub/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

AI, LLMs & Agents

Unity Async Patterns

40

Nice-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.

Writing & Content

Write a Skill

57

javimosch/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.

Writing & ContentIn 1 list

Unity Cinemachine

40

Nice-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.

Writing & Content

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.