writing-markdownlisted
Install: claude install-skill woznet/wozdev
# Writing Markdown
Author Markdown that is well-structured, portable, and free of syntax errors - then prove it with `rumdl`.
**Core rule:** Use ATX headings in a strict hierarchy, surround every block element with blank lines, tag every fenced code block with a language, and use one consistent list marker - then run `rumdl check --color never --no-cache --fix` and resolve every remaining violation. Pass `--color never` to every rumdl command, and `--no-cache` to every `check` and `fmt`.
## When to Use This Skill
- Writing or generating any Markdown file (README, docs, changelog, wiki page)
- Reviewing or refactoring existing `.md` / `.markdown` files
- Fixing reported Markdown syntax errors or lint failures
- Setting up Markdown linting and formatting for a project with rumdl
## Prerequisites
Supported platforms: 64-bit Ubuntu (26.04) and 64-bit Windows 11.
1. Check for rumdl: `rumdl --color never --version`. If it prints a version, skip to the workflow.
2. If it is missing, install the GitHub release binary with the bundled script for the platform:
- Linux: `bash <skill-dir>/scripts/install-rumdl.sh` - installs to `~/.local/bin/rumdl`.
- Windows: `powershell -NoProfile -ExecutionPolicy Bypass -File <skill-dir>/scripts/Install-Rumdl.ps1` (or `pwsh -NoProfile -File ...`) - installs to `%LOCALAPPDATA%\Programs\rumdl\rumdl.exe` and adds that folder to the user PATH.
3. Both scripts install the latest release by default, take a tag such as `v0.3.0` to pin a version,