What it does
Generates well-structured technical documentation in Markdown. Use when a user asks to write docs, create a README, document an API, write a how-to guide, generate technical documentation, create a changelog, write a project wiki, or produce any structured Markdown content. Follows documentation best practices for clarity and completeness.
This entry summarizes the public skill for discovery. Prefer the upstream SKILL.md for the full instruction text (we do not paste restricted or lengthy proprietary prompt bodies).
Install & usage
Multi-agent install (Terminal Skills CLI)
npx terminal-skills install markdown-writer
Manual curl examples:
# Claude Code
curl -sL https://raw.githubusercontent.com/TerminalSkills/skills/main/skills/markdown-writer/SKILL.md -o .claude/skills/markdown-writer.md
# Codex
curl -sL https://raw.githubusercontent.com/TerminalSkills/skills/main/skills/markdown-writer/SKILL.md -o .codex/skills/markdown-writer.md
# Cursor
curl -sL https://raw.githubusercontent.com/TerminalSkills/skills/main/skills/markdown-writer/SKILL.md -o .cursor/skills/markdown-writer.md
Best for
Technical documentation with consistent structure.
Hands-on test
- test_level: fully-tested
- Ran: yes
- When: 2026-11-01T01:20:00+08:00 (Asia/Shanghai)
- Result: Generated a structured Markdown doc with headings/lists and verified file write.
- Gotchas: Style guidance is soft; project lint (markdownlint) may still fail.
Money-saving tip
Skills are free/open-source; spend goes to your agent plan. Start on Cursor Plus ($8/mo) or Claude Pro / ChatGPT Go before upgrading.
Source & license
- source_repo: TerminalSkills/skills
- Source: https://github.com/TerminalSkills/skills/tree/main/skills/markdown-writer
- License: Apache-2.0 — https://github.com/TerminalSkills/skills/blob/main/LICENSE
- Restrictions: Repo LICENSE is Apache-2.0; keep NOTICE/attribution. Some catalog skills wrap third-party SaaS — those need their own accounts/keys.