Improve with AI gives you the power of a personal senior editor. It keeps in mind the context of all your other articles and your AI style guide.
How to Use Improve with AI
- Head to your article
- Click Improve in the bar at the bottom right of the editor

- Click Run analysis. Each analysis uses 5 AI credits.
- Wait for HelpDocs AI to work its magic and analyze your article (this usually takes seconds)
- Review your results and see suggestions highlighted inline

HelpDocs AI will scan through your entire article, and any open comments your team has left on it, looking for ways to make it clearer, more engaging, and easier to understand.
You'll get a total score out of 100, plus specific suggestions for improvement. Generally, scores above 80 indicate well-optimized content, while scores below 60 suggest room for significant improvement.
Once the analysis is complete, you'll see improvement suggestions highlighted in your article text. These only appear when the Improve with AI panel is open.
Click any highlighted section to see the suggestion callout. You can apply changes right there.
You can also implement suggestions by clicking Apply in the main panel, or apply every remaining suggestion at once with Apply all. Click the X on a suggestion to dismiss it.
If you edit the article after an analysis, you'll see a warning that some suggestions may no longer fit, with a Review again button. Reviews also expire after a while: once one has, click Re-run to apply suggestions again.
Focus on the highest-impact recommendations first, and don't feel obligated to implement every suggestion. Use your judgment to decide what fits best for your content and audience.
What Improve with AI Looks For
Every suggestion falls into one of six categories. You'll see them as groups in the panel, each with a count of how many suggestions it holds.
Category | What it checks | Example suggestion |
|---|---|---|
Readability | Sentence length, reading level, clarity, jargon, and passive voice | Split the long opening sentence into two |
Completeness | Missing information, unclear steps, and gaps a reader would run into | Explain where to find the download link |
Tone | An inconsistent voice, the wrong register, or anything that drifts from your AI style guide | Match the friendly tone used in the rest of the article |
Links | Topics that should link to another article, and existing links that look wrong | Link to the article about AI credits |
SEO | The title, description, headings, and keyword coverage, so readers can find the article in search | Use the term readers search for in the first heading |
Structure | Heading hierarchy, formatting, lists, callouts, and how the article flows | Turn the setup steps into a numbered list |
How Suggestions Are Labeled
Each suggestion also has a severity, so you can tell at a glance which ones matter most:
Severity | What it means |
|---|---|
High | A significant problem your readers will run into |
Medium | A noticeable issue worth fixing |
Low | Polish, for when the bigger things are done |
Under the Apply button, each suggestion tells you how it can be applied:
Label | What it means |
|---|---|
1 credit | HelpDocs AI can make the change for you, such as rewording a sentence, adding a link, or fixing a heading |
Manual | The change needs your judgment, such as confirming a fact, deciding what to cut, or editing the title, description, or tags |
An analysis returns up to 12 suggestions. If your article is already in great shape, you'll get a high score and fewer suggestions, or none at all.
Sharing Suggestions with Your Team
Want to collaborate on improvements? You can download a PDF that details all the improvement suggestions. This makes it easy to share analysis results with your team for review and discussion.