← ClaudeAtlas

wise-human-writinglisted

Human-first writing rules for EVERY outbound message composed on the user's behalf - ticket descriptions and comments in ANY issue tracker (Jira, Linear, GitHub Issues, GitLab, Asana, Monday, YouTrack, …), PR / MR descriptions, comments, and review replies on ANY code host (GitHub, GitLab, Bitbucket, …), pages and specs in ANY doc system (Confluence, Notion, Google Docs, …), and chat messages (Slack, Teams, Discord, …). ALWAYS consult this skill before drafting or posting any such content, whichever MCP server, CLI, or API is in play: structure every message as context → reasoning → conclusion, write at business level instead of dumping code identifiers, never use ASCII diagrams, and emit the correct native markup per tool. Also invocable as `/wise-human-writing [<draft>]` (bare alias) or `/wise:wise-human-writing` (canonical) to rewrite - "de-slop" - an existing draft without posting it anywhere. Use when creating or updating a ticket, commenting on an issue or PR, posting a status update to Slack, writing a
e1024kb/wise-claude · ★ 4 · AI & Automation · score 80
Install: claude install-skill e1024kb/wise-claude
# wise-human-writing - write for humans, not for logs Before asking any user question, read and follow the [question lifecycle](../../references/workflow-host-control.md#keep-asynchronous-questions-open). Keep asynchronous prompts open until answered; this rule does not authorize questions in autonomous or otherwise prompt-free procedures. ## Why this skill exists Messages generated straight from a work session read like the work session: exhaustive, symbol-heavy, structureless. The reader of a Jira comment or a Slack update was not in that session. They need the *story* - what happened, why, what's next - in the order a human tells it, at the altitude a human cares about. This skill is the standing contract for every outbound message: it defines the structure, the altitude, and the per-tool formatting so that anything posted on the user's behalf reads like a sharp colleague wrote it. ## Two ways this skill runs 1. **Standing reference (the main mode).** Consult these rules automatically whenever composing content that will land in front of other humans through an external tool: ticket descriptions, tracker comments, PR/MR descriptions or comment replies, doc pages, chat messages. It does not matter which tracker, code host, doc system, or chat product is in play, or whether the write happens through an MCP server, a CLI (`gh`, `glab`, `jira`, `linear`), or a raw API call - if a human will read it in another tool, these rules apply. 2. **Slash rewrit