How do I install the Markdown Formatting skill?

Run npx skillmds@latest add tomevault-io/markdown-formatting in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Markdown Formatting safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Markdown Formatting?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Markdown Formatting free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Markdown Formatting?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Markdown Formatting by tomevault-io

Name: Markdown Formatting
Author: tomevault-io

File contents

Markdown Formatting Skill

Apply consistent Markdown formatting to all outputs. Structure content for readability and professionalism.

When to Use

Activate when producing:

PR descriptions and issue bodies
Documentation and guides
Notes and summaries
Any structured text output

Core Principles

Lead with the point - TL;DR or summary first, details after
Use structure - Headings, lists, and whitespace aid scanning
Be consistent - Same patterns across all outputs
Respect context - PRs need checklists, docs need examples

Formatting Rules

Document Structure

# Title (standalone documents only)

Brief summary or TL;DR (1-2 sentences)

## Section Heading

Content organized by topic...

Headings

Use ## for main sections (reserve # for document title)
Use ### sparingly for subsections
Never skip levels (no ## to ####)

Lists

Use - for unordered lists (not *)
Use 1. for ordered/sequential steps
Nest with 2-space indent
Keep list items parallel in structure

Code

Inline: backticks for commands, filenames, variables
Blocks: triple backticks with language identifier
Always specify language: typescript, bash, ```json

Emphasis

Bold for key terms, warnings, important points
Italics sparingly for emphasis or introducing terms
Never combine bold and italics

Templates

PR Description

## Summary

[One-line description of the change]

## Changes

- [Change 1]
- [Change 2]

## Test Plan

- [ ] [Test case 1]
- [ ] [Test case 2]

Issue Body

## Problem

[What is wrong or missing]

## Steps to Reproduce

1. [Step 1]
2. [Step 2]

## Expected

[What should happen]

## Actual

[What actually happens]

Anti-patterns

Walls of text without structure
Inconsistent list markers (*, -, + mixed)
Code blocks without language identifiers
Headings used as emphasis
Trailing whitespace or excessive blank lines

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: markdown-formattingdescription: Format AI outputs into consistent, readable Markdown for PRs, issues, docs, and notes Use when this capability is needed.---# Markdown Formatting SkillApply consistent Markdown formatting to all outputs. Structure content for readability and professionalism.## When to UseActivate when producing:- PR descriptions and issue bodies- Documentation and guides- Notes and summaries- Any structured text output## Core Principles1. **Lead with the point** - TL;DR or summary first, details after2. **Use structure** - Headings, lists, and whitespace aid scanning3. **Be consistent** - Same patterns across all outputs4. **Respect context** - PRs need checklists, docs need examples## Formatting Rules### Document Structure```# Title (standalone documents only)Brief summary or TL;DR (1-2 sentences)## Section HeadingContent organized by topic...```### Headings- Use `##` for main sections (reserve `#` for document title)- Use `###` sparingly for subsections- Never skip levels (no `##` to `####`)### Lists- Use `-` for unordered lists (not `*`)- Use `1.` for ordered/sequential steps- Nest with 2-space indent- Keep list items parallel in structure### Code- Inline: backticks for `commands`, `filenames`, `variables`- Blocks: triple backticks with language identifier- Always specify language: ```typescript, ```bash, ```json### Emphasis- **Bold** for key terms, warnings, important points- *Italics* sparingly for emphasis or introducing terms- Never combine bold and italics### Links- Descriptive text: `[installation guide](url)` not `[click here](url)`- Reference issues/PRs with `#123` format## Templates### PR Description```markdown## Summary[One-line description of the change]## Changes- [Change 1]- [Change 2]## Test Plan- [ ] [Test case 1]- [ ] [Test case 2]```### Issue Body```markdown## Problem[What is wrong or missing]## Steps to Reproduce1. [Step 1]2. [Step 2]## Expected[What should happen]## Actual[What actually happens]```## Anti-patterns- Walls of text without structure- Inconsistent list markers (`*`, `-`, `+` mixed)- Code blocks without language identifiers- Headings used as emphasis- Trailing whitespace or excessive blank lines---> Converted and distributed by [TomeVault](https://tomevault.io/claim/britt) — claim your Tome and manage your conversions.

Frequently asked questions

Markdown Formatting