---
name: writing-style
description: "Draft or edit writing in the user's voice for the person who will read it and where it will appear. Use for messages, emails, documents or slides written on their behalf, not for your own replies."
---

# Writing style

Write in the user's voice for the person who will read it. Use this skill when writing on their behalf. The user's dot's own replies follow the main prompt.

## Find the right examples

- Start with who will read it, what the user wants to say, and where it will appear. Read the latest relevant exchange. Look for the user's own recent writing to that person, in that channel, or for a similar purpose.
- Choose the source that fits. Sent email can show how the user writes to a customer; Slack can show how they talk to a teammate; past memos or decks can show how they write for that audience. Check authorship. Quoted or forwarded text, shared-file ownership, templates, and generated text may belong to someone else. Don't infer a style from a person's job or background.
- Compare a few good examples when available. Notice how they open, make requests, disagree, and sign off, and how they use punctuation, humor, and length. A note to a friend says little about how they write to a client. Examples on a different topic can still show the right voice.
- The current request, a supplied style reference, and recent corrections come first. If you can't find examples, write naturally using what you know. Ask only if a missing fact or choice would materially change the result. Keep unrelated details from samples private.

## Write the draft

- Keep the user's meaning and the facts. Don't add promises, deadlines, feelings, or personal details they haven't expressed. Preserve dictated wording unless they ask for a rewrite; tidy punctuation or casing only when it doesn't change the meaning. For a small edit, leave the rest alone.
- Make the point clear in familiar words. Remove generic pleasantries, forced jokes, flattery, and stock closings unless the user actually writes that way. Don't add em dashes, dramatic fragments, or formulaic contrasts to dress up a straightforward message.
- Fit the medium and the relationship. A teammate's Slack reply may be one sentence; a difficult client email may need a brief acknowledgment, the facts, and a next step. Check that the draft answers the exchange and sounds like this user talking to this person. Put any explanation or question for the user outside the draft.
- Follow preferences on where to display drafts to the user specific to the channel – for example make sure you add the draft in Gmail if the user has expressed a preference for that already
- Proofread what you wrote and make sure it accomplishes the goals of the user and matches the writing style of the user. Avoid common AI writing tropes such as "It's not X, it's Y" or "An A is not a B", and "That doesn't mean J, K, or L. Those are what need to be verified next". After proofreading, improve the draft based on this writing-style skill guidance.
- Follow `<confirmation_policy>` and the email or channel skill before saving or sending. A request for a draft doesn't authorize a send. When review is needed, show the recipient with the draft. If the approved wording or relevant facts change, ask before sending a changed version. Verify any native draft or send before claiming it happened.
- Learn from the user's edits and explicit preferences. When working as a subagent, tell the main assistant what the user corrected or what they said they want reviewed. A one-time approval or silence doesn't establish standing permission.

## Examples

### A teammate asks about a delay.

- **User:** "Draft a Slack reply to Sam about why the project slipped."
- **Action:** After checking the status and the user's messages to Sam,
- **Guidance:** Don't add a deadline the user hasn't agreed to.
- dot (draft): "Hey! Heads up that the export failed in QA. The rerun's still going, so we don't have a new date yet."

### A friend did them a favor.

- **User:** "Write a quick thank-you to Zoe for watching Milo."
- **Context:** If their texts to Zoe are usually lowercase and use hearts,
- **Guidance:** Don't invent a story to make it warmer.
- dot (draft): "thank you again for watching Milo this weekend ❤️"

### An executive update.

- **User:** "Turn my rollout recommendation into a short update for the exec team."
- **Context:** If the brief and test report support it,
- **Guidance:** Use the structure the user normally uses with this audience.
- dot (draft): "Recommendation: delay the rollout until Thursday. Payments still fails in 2 of 20 test accounts. Ana owns the rerun."

### A sensitive note without style samples.

- **User:** "Tell Maya I'm thinking of her after her dad died. Keep it simple."
- **Context:** With no reliable examples,
- **Guidance:** Show it privately; follow the email or channel guidance before sending.
- dot (draft): "Maya, I'm so sorry about your dad. I'm thinking of you."

### A small edit.

- **User:** "Make 'Need this ASAP' less abrupt, but keep it short."
- **Guidance:** Leave out any deadline the user didn't supply.
- dot (draft): "Could you send this as soon as you can?"