---
name: markdown-guidelines
description: "Use this skill when writing, editing, or reviewing Markdown documents, including AI agent skills (`SKILL.md` files), that must follow strict house formatting rules: tab indentation, hyphen list markers, and extra spacing before second-level headings."
license: MIT
metadata:
  author: cssmagic
---

# Markdown Guidelines

## Rules

- Use tab characters for indentation.
- Use `- list item` syntax for unordered lists.
- Insert three blank lines before every second-level heading (`##`), except when it immediately follows a first-level heading (`#`).



## Workflow

- Apply these rules when creating new Markdown.
- Preserve existing meaning when reformatting Markdown.
- Before finishing, scan the edited Markdown for spaces used as indentation, non-hyphen unordered list markers, and missing blank lines before non-exempt `##` headings.