# Writing Clearly

> Help PMs write clear, concise prose for PM artifacts. Use for PRDs, status updates, Slack posts, emails, and documentation.

- **Type:** Skill
- **Install:** `agentstack add skill-hardiktiwari-pm-operating-os-writing-clearly`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [hardiktiwari](https://agentstack.voostack.com/s/hardiktiwari)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [hardiktiwari](https://github.com/hardiktiwari)
- **Source:** https://github.com/hardiktiwari/PM-operating-OS/tree/main/skills/writing-clearly

## Install

```sh
agentstack add skill-hardiktiwari-pm-operating-os-writing-clearly
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Writing Clearly

Help PMs write clear, concise prose for PM artifacts. Applies principles of plain language, structure, and scannability to make communications effective and easy to act on.

## When to Use

- Writing or editing a PRD
- Drafting status updates or stakeholder comms
- Composing Slack posts or emails
- Creating documentation or runbooks
- When asked "help me make this clearer" or "tighten this up"

## Process / Template

### 1. Identify the Artifact and Audience

- What are you writing? (PRD, update, post, doc)
- Who will read it? (engineers, leadership, customers)
- What do they need to do? (decide, build, understand, act)

### 2. Apply Clear Writing Principles

**Lead with the main point**
- Put the conclusion or ask first
- Don't bury the lead in the last paragraph

**Use plain language**
- Prefer short words over long (use vs. utilize, help vs. facilitate)
- Prefer active voice (we will ship vs. it will be shipped)
- Cut jargon unless the audience expects it

**Be specific**
- Use numbers, dates, names instead of "soon," "many," "several"
- Replace vague terms with concrete ones

**Structure for scannability**
- Use headers, bullets, and short paragraphs
- One idea per paragraph
- Front-load key info in each sentence

**Cut ruthlessly**
- Remove filler (e.g., "in order to" → "to")
- Remove redundancy
- If a sentence doesn't add value, cut it

### 3. Use the Right Format

| Artifact | Key Moves |
|----------|-----------|
| PRD | Clear problem statement, explicit requirements, scannable sections |
| Status update | TL;DR first, bullets, metrics, explicit asks |
| Slack/email | Short paragraphs, one ask per message |
| Doc/runbook | Step-by-step, headers, examples |

### 4. Edit in Passes

- **Pass 1** — Structure: does the order make sense?
- **Pass 2** — Clarity: can a reader understand it in one pass?
- **Pass 3** — Brevity: what can be cut?

### 5. Validate

- Can the reader answer: What? Why? What do I do?
- Would a busy executive get it in 2 minutes?
- Are there ambiguous pronouns or missing context?

## Output

Clear, concise prose that:
- Communicates the intended message
- Is easy to scan and act on
- Respects the reader's time
- Fits the format (PRD, Slack, email, doc)

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [hardiktiwari](https://github.com/hardiktiwari)
- **Source:** [hardiktiwari/PM-operating-OS](https://github.com/hardiktiwari/PM-operating-OS)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-hardiktiwari-pm-operating-os-writing-clearly
- Seller: https://agentstack.voostack.com/s/hardiktiwari
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.