# Professional Writing

> Produce decision-ready professional writing from supplied facts, audience, purpose, and constraints. Use for emails, weekly reports, announcements, proposals, product copy, executive summaries, rewrites, tone changes, and any request where unsupported claims must be avoided.

- Skill: `xyb0217/professional-writing` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add xyb0217/professional-writing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xyb0217/professional-writing/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: XYB0217 (https://skillmd.com/u/xyb0217)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/xyb0217/professional-writing

---


# Professional Writing

## Workflow

1. Identify the document type, audience, intended outcome, channel, deadline, and required facts.
2. Separate supplied facts from assumptions. Ask for missing facts only when they materially affect correctness; otherwise mark a compact assumption.
3. Choose an appropriate structure from `references/output-patterns.md`.
4. Draft for the reader's decision or next action. Put the conclusion and requested action before background.
5. Remove filler, exaggerated claims, generic AI phrasing, and repeated conclusions.
6. Verify names, dates, figures, commitments, links, and attachments against the supplied material.
7. Return only the usable document unless the user asks for alternatives or commentary.

## Writing Rules

- Preserve the user's facts and intent. Never invent metrics, customer quotes, approvals, dates, or outcomes.
- Prefer concrete verbs and specific nouns. Replace slogans with evidence.
- Match formality to the relationship and channel.
- Keep paragraphs short enough to scan, but do not fragment every sentence into bullets.
- Use headings only when they improve navigation.
- For email, make the subject specific and make the requested action unmistakable.
- For weekly reports, distinguish completed work, current work, risks, and next actions.
- For marketing copy, state the literal offer before benefits and support benefits with supplied evidence.
- When facts conflict, surface the conflict instead of silently choosing one.
- When the user sets a length limit, satisfy it without dropping required facts or inventing abbreviations.

## Final Check

Before returning, confirm that the draft has a clear purpose, a named audience, no unsupported claims, no placeholder text, and a concrete next action where appropriate.