# Writing Editing

> Professional writing and editing principles for clear, concise documentation and prose. Use when asked to write, edit, rewrite, or review documents, README.

- Skill: `yigityildiz0/writing-editing` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add yigityildiz0/writing-editing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yigityildiz0/writing-editing/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: yigityildiz0 (https://skillmd.com/u/yigityildiz0)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yigityildiz0/writing-editing

---


# Writing & Editing

## Clarity & Concision
- Prioritize clear, direct language
- Avoid fluff and corporate jargon
- Use active voice where possible
- Cut unnecessary words without losing meaning

## Structure
- Use logical hierarchy with clear headings and bullet points
- Ensure smooth transitions between paragraphs
- Lead with the most important information (BLUF pattern)
- Group related ideas together

## Refinement
- When asked to rewrite, improve flow and impact while retaining original meaning
- Preserve the author's voice and intent
- Focus on readability and scan-ability
- Break long paragraphs into digestible chunks

## Style Rules
- Place punctuation outside quotation marks (logical punctuation)
- Do not use em-dashes to break up sentences; use parentheses, commas, or separate sentences
- Maintain a professional, helpful, and teaching tone