# markdown-drafts

> Claude/Codex skill by [@cloudflare](https://omgskills.com/library/cloudflare/index.md) · 8.6k stars · Updated 2026-08-25

Use markdown formatting when drafting content intended for external systems (GitHub issues/PRs, Jira tickets, wiki pages, design docs, etc.) so formatting is preserved when the user copies it. Load this skill before producing any draft the user will paste elsewhere.

## Install

```sh
git clone https://github.com/cloudflare/workerd /tmp/workerd && ln -s /tmp/workerd/.opencode/skills/markdown-drafts ~/.claude/skills/markdown-drafts
```

## From README

Markdown Drafts When the user asks you to draft, write, or compose content that will be copied into an external system — GitHub issues, pull request descriptions, Jira tickets, wiki pages, design documents, RFCs, or similar — always use markdown syntax so that formatting survives the copy-paste. When This Applies GitHub issues and pull request descriptions Jira ticket descriptions and comments Confluence / wiki page drafts Design documents and RFCs Slack messages (Slack renders a subset of markdown) Any content the user explicitly says will be copied elsewhere Formatting Rules Use \#, \#\#, \#\#\# headers to create structure Use - or for unordered lists, 1. for ordered lists Use triple-backtick fenced code blocks with language tags (e.g., \#\# My Heading bullet one bold text and code This ensures the user sees and can copy the exact markdown source. Never render the draft as formatted text outside a code fence — the markup will be silently consumed by the chat UI.

## Links

- HTML page: https://omgskills.com/skills/cloudflare/workerd/markdown-drafts/
- GitHub: https://github.com/cloudflare/workerd
- Author: [@cloudflare](https://omgskills.com/library/cloudflare/index.md)

## More from this repo

- [bazel-test-hygiene](https://omgskills.com/skills/cloudflare/workerd/bazel-test-hygiene/index.md) — Mandatory rules for running bazel tests during development.
   - [@cloudflare](https://omgskills.com/library/cloudflare/index.md) · 8.6k stars
- [commit-categories](https://omgskills.com/skills/cloudflare/workerd/commit-categories/index.md) — Commit categorization rules for changelogs and "what's new" summaries.
   - [@cloudflare](https://omgskills.com/library/cloudflare/index.md) · 8.6k stars
- [dad-jokes](https://omgskills.com/skills/cloudflare/workerd/dad-jokes/index.md) — After completing any task that took more than ~5 tool calls, or after long-running builds/tests finish, load this skill...
   - [@cloudflare](https://omgskills.com/library/cloudflare/index.md) · 8.6k stars