# 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]].