← ClaudeAtlas

writing-markdownlisted

Conventions, a document scaffold, and a rumdl lint/format workflow for writing high-quality Markdown. Use when writing, generating, reviewing, or fixing Markdown - READMEs, docs, wikis, changelogs, or any .md / .markdown file. Covers ATX headings and strict hierarchy, blank-line spacing around blocks, fenced code blocks with language tags, consistent list markers and indentation, tables, descriptive links and image alt text, and linting and auto-fixing every file with rumdl (check, check --fix, fmt) until zero violations remain, without leaving a rumdl cache behind (--no-cache). Installs rumdl from its GitHub release binary on 64-bit Linux or Windows when it is missing.
woznet/wozdev · ★ 0 · Data & Documents · score 72
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,