Markdown

Skill bmaltais/skills/markdown

Comprehensive Markdown best practices and formatting rules, aligned with markdownguide.org, markdownlint, and CommonMark spec 0.31.2. Use when writing or reviewing Markdown files. Trigger on phrases like "format this markdown", "markdown best practices", "fix my markdown", "lint markdown", "markdown style".From its SKILL.md

Install

npx -y skills add bmaltais/skills --skill markdown

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.8 KB, 313 tokens by cl100k_base, as published. Nobody here has run it

Markdown Documentation & Formatting

Write Markdown that is correct, consistent, clear, and accessible.

Core Principles

Consistency — ATX headings, - for lists, **bold**/*italic*, fenced code blocks with language IDs.
Clarity — Descriptive headings, logical hierarchy, short paragraphs, active voice.
Correctness — Passes all markdownlint rules, aligns with CommonMark 0.31.2.
Accessibility — Descriptive link text, meaningful alt text, no skipped heading levels.

Routing Table

Topic	Reference
CommonMark syntax rules & compliance	`references/commonmark.md`
Editor setup & linting configuration	`references/tooling.md`
Validation checklist	`references/checklist.md`

Key Rules (Always Apply)

Use ATX-style headings (#) only — never setext (===/---).
Only one H1 per document.
No skipped heading levels (H1 → H2 → H3, not H1 → H3).
Fenced code blocks must specify a language identifier.
No trailing whitespace; file ends with a single newline.
No bare URLs — use [text](url) link syntax.
Use - for unordered lists (not * or +).
Match existing style when editing a file.

What ships with it: 3 files

5.3 KB alongside SKILL.md