Markdown

SkillFiles & storage

Gives your agent a markdown claude skill of writing rules so every .md file it writes or edits stays clear and well structured.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Markdown skill

About this skill

The rules for every Markdown file in the repository, inside docs/ or not: prose a reader understands on the first pass, MECE structure, headings rather than bold, checklists for TODOs. Read before writing or editing any Markdown (.md) file.

What this skill tells your AI

The instructions your AI receives, as published by wado-lang/wado in .claude/skills/markdown/SKILL.md and read by ahel’s review.

The goal is prose a reader understands on the first pass. Everything below serves that.

Prose

  • Plain words. One idea per sentence. The plain statement first, the reason for it after.
  • Three habits make a reader decode instead of read: a second clause hung off a dash, an abstract noun standing where a verb would do, and the clever phrasing of a point arriving before the obvious one. Undo each where you find it.
  • Correct and fresh. Keep the facts.
  • Cutting narration and redundancy is one way to get there. It is not the point. A passage that came out shorter and harder to follow has failed.

Structure

  • Keep a document simple and MECE.
  • Do not use **...** (bold) for sub-sections. Use Markdown sections instead.
  • Use a Markdown checklist for TODOs (- [ ] ...) and what's done (- [x] ...).

Finish

Run mise run format after editing.

Signals

GitHub stars
116
Forks
2
Last commit
Sep 2026
Advanced
Catalog kind
skill
Key
markdown-wado-lang
Source
github.com/wado-lang/wado