> For the complete documentation index, see [llms.txt](https://docs.voicemoat.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.voicemoat.com/tones-and-improve.md).

# Tones and Improve

**In short:** tones rewrite a draft in a different register while staying in your voice; Improve is a heavier rewrite pass, either a quick set of options or one deep polish. Both are in Studio.

### Tones

A tone shifts the register of a draft without leaving your voice. Pick one and audenAI rewrites the post to match it. There are 13 tones:

Hype, Thoughtful, Witty, Roast, Agree and Build, Respectful Pushback, Concise, Story, Probing Question, Contrarian, Chill, Provocative, Educational.

{% hint style="info" %}
Two tones (Roast and Chill) are Twitter-only, since they rarely fit LinkedIn. The rest are available on both platforms. Tones are the same set you will see in the Engage reply grid.
{% endhint %}

A tone rewrite is credit-metered (it is one generation), and it always writes in your trained voice, so "Witty" comes out as *your* witty, not a generic one.

### Improve

Improve is a bigger rewrite than a single tone shift. It has two modes:

| Mode      | What it does                                                 | Cost      |
| --------- | ------------------------------------------------------------ | --------- |
| **Quick** | Returns 2 to 3 fast rewrites to pick from                    | 3 credits |
| **Full**  | One deep pass: grammar, then hook, then line breaks and flow | 5 credits |

**Quick** is for "give me a few options". **Full** is for "make this genuinely better", and it runs a more thorough pass (and on Enterprise, a closer best-of read) before handing you the result.

{% hint style="info" %}
Improve applies its result back into your Studio draft, so you can keep editing from there. If a pass fails, the credits are refunded.
{% endhint %}

### When to use which

* **Tone**: you like the draft but want a different feel.
* **Quick Improve**: you want a couple of alternative takes to choose from.
* **Full Improve**: the draft is rough and you want one clean, polished version.

### Common questions

**Do tones change my voice?** No. A tone changes the register (more hype, more concise) while keeping your voice underneath. That is the point.

**Why does Full cost more than Quick?** Full does more work: a multi-step pass and, on higher tiers, a best-of read. Quick is a fast handful of options.

**Can I undo an Improve?** Improve writes into your draft, so your previous text is replaced. Copy anything you want to keep first, or re-draft.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.voicemoat.com/tones-and-improve.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.