# AI Writing Assistant
The AI Writing Assistant helps you refine task descriptions directly in the task window. Select some text and choose **Improve** from the formatting toolbar. No side panel is needed.
> [!quote] Better descriptions, less effort
>
> Clear task descriptions reduce context-switching later. The writing assistant helps you get them right without disrupting your flow.
## How to use it
1. Open any task and go to the description
2. Select the text you want to improve: a sentence or more
3. Choose **Improve** at the start of the formatting toolbar
**Improve** appears once your selection is long enough to work with. On narrower screens you will find it in the toolbar's **More** menu. See [[Rich Text Editing]] for the rest of the toolbar.
AI Improve accepts a selection of up to 20,000 characters. For a longer description, select one section at a time.
## Review the suggestion
Your suggestion opens in the **AI Improve** panel. From there you can:
- **Replace** - swap the selected text for the suggestion
- **Insert below** - keep your original and add the suggestion underneath it
- **Copy** - copy the suggestion to use somewhere else
- **Create as actions** - when the suggestion contains a list, turn the items you pick into [[Add Tasks#Break a task into actions|actions]] on the task
- **Ask to edit or write** - type a follow-up, such as "make it shorter" or "turn this into steps", to refine the suggestion before you use it
![[ai-improve-panel.png]]
> [!tip] Use it on the whole description or just a section
> Select the entire description for a full rewrite, or just a sentence or paragraph to refine one part. The assistant works on whatever you select.
Improve works on the text you selected, with its supported formatting. Its follow-up conversation belongs to that selection and editor, separate from Ask Zaphiri in the sidebar. Review the result before choosing **Replace** or **Insert below**.
If your selection includes unsupported rich content, such as images or checklists, select a text-only section instead. If access, the editor, or the connection changes, start a new Improve request from the current text.
Close the panel to keep your description exactly as it was.
---
**Next:** For the full chat assistant, see [[AI Chat Assistant]].