> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/actions/grids/run-content-review-on-your-output.md).

# Run Quality Scoring on your Output

### Overview

Content Review runs automated quality checks on generated content before you publish.

Each check tells you what could be improved and why. You decide what to act on: suggestions can be applied with one click or ignored entirely. Content Review is available on all plans.

### How Scoring Works

Content Review scores each output out of 100 points.

The score is made up of two parts:

| Score area         | Points | What it measures                                               |
| ------------------ | ------ | -------------------------------------------------------------- |
| AI Discoverability | 50     | How likely your content is to be found and cited in AI search. |
| Brand Adherence    | 50     | How well your content follows your Brand Kit writing rules.    |

AI Discoverability includes checks across Information Gain, Search Intent, E-E-A-T, and Readability. Brand Adherence checks writing rule adherence.

The check weights below are shown as points out of the full 100-point Content Review score.

### How to Configure Content Review

You can configure Content Review from two places:

* **From Playbook artifacts:** Select the artifact you want to score, such as a final article, draft article, or other generated output.
* **From Grid:** Open the menu on a workflow output column, then select **Content Review**.

After Content Review is configured, click the **Content Review** icon on an output to run the checks and view the score.

<figure><img src="/files/H7ERPKQB95F7nVr5hb40" alt=""><figcaption></figcaption></figure>

### Available Checks

SERP means search engine results page. E-E-A-T means experience, expertise, authoritativeness, and trustworthiness.

<table><thead><tr><th width="156.7265625">Category</th><th>Check</th><th width="135.3671875">Score weight</th><th>What it checks</th></tr></thead><tbody><tr><td>Brand Adherence</td><td>Check writing rule adherence</td><td>50</td><td>Checks whether the content follows the active Brand Kit writing rules.</td></tr><tr><td>Information Gain</td><td>Check for net-new knowledge beyond top SERP results</td><td>10</td><td>Checks whether the content adds original value beyond what already ranks, such as unique data, first-party examples, expert perspective, or a new angle.</td></tr><tr><td>Information Gain</td><td>Review coverage of top SERP topics</td><td>10</td><td>Checks whether the content covers the table-stakes topics that top search results already address for the target keyword.</td></tr><tr><td>Search Intent</td><td>Check answer completeness for the target prompt</td><td>5</td><td>Checks whether the content fully answers the target prompt, including supporting questions the searcher would expect covered.</td></tr><tr><td>Search Intent</td><td>Check intent matches the dominant SERP intent</td><td>5</td><td>Checks whether the content has the right goal for the search result, such as educational, comparison, commercial, or product-focused.</td></tr><tr><td>Search Intent</td><td>Check keyword presence in H2 headings</td><td>0.5</td><td>Checks whether at least one H2 heading includes the target keyword or a close keyword variant.</td></tr><tr><td>Search Intent</td><td>Check keyword in intro (first 100 words)</td><td>0.5</td><td>Checks whether the target keyword or a close variant appears near the beginning of the content.</td></tr><tr><td>Search Intent</td><td>Review keyword density</td><td>0.5</td><td>Checks whether the target keyword is used naturally throughout the content, without being missing or overused.</td></tr><tr><td>E-E-A-T</td><td>Check for concrete first-party insights</td><td>5</td><td>Checks whether the content includes the brand's own data, customer examples, research, or results with concrete details.</td></tr><tr><td>E-E-A-T</td><td>Check the article's topic fits the brand's expertise</td><td>2.5</td><td>Checks whether the article's main topic fits the brand's demonstrated expertise and authority.</td></tr><tr><td>E-E-A-T</td><td>Check named sources for third-party claims</td><td>2.5</td><td>Checks whether third-party claims that need proof name a specific source, instead of using vague phrases like "research shows."</td></tr><tr><td>E-E-A-T</td><td>Check source links for third-party claims</td><td>2.5</td><td>Checks whether third-party claims that need proof include a link to the source.</td></tr><tr><td>E-E-A-T</td><td>Review internal link count</td><td>0.5</td><td>Checks whether the content includes an appropriate number of links to related pages on the same site.</td></tr><tr><td>E-E-A-T</td><td>Review external link count</td><td>0.5</td><td>Checks whether the content includes an appropriate number of links to relevant outside sources.</td></tr><tr><td>E-E-A-T</td><td>Check for broken links</td><td>0.5</td><td>Checks whether links in the content are reachable, and flags broken links or links that need manual review.</td></tr><tr><td>Readability</td><td>Check format matches the dominant SERP format</td><td>2.5</td><td>Checks whether the content uses the format searchers expect, such as a guide, listicle, comparison, how-to, or landing page.</td></tr><tr><td>Readability</td><td>Review sentence conciseness</td><td>0.5</td><td>Checks whether sentences are short enough to be easy for readers, search engines, and AI systems to parse.</td></tr><tr><td>Readability</td><td>Review paragraph length and scannability</td><td>0.5</td><td>Checks whether paragraphs are short and focused enough to scan easily.</td></tr><tr><td>Readability</td><td>Review bullet brevity and completeness</td><td>0.25</td><td>Checks whether bullet points are concise, complete, and easy to scan.</td></tr><tr><td>Readability</td><td>Review list item grammatical consistency</td><td>0.25</td><td>Checks whether list items follow a consistent grammatical pattern, format, and punctuation style.</td></tr><tr><td>Readability</td><td>Review heading hierarchy consistency</td><td>0.25</td><td>Checks whether headings are structured correctly, with a clear H1 and no skipped heading levels.</td></tr><tr><td>Readability</td><td>Review heading clarity and descriptiveness</td><td>0.25</td><td>Checks whether headings clearly describe each section, without vague, overly promotional, or overly long wording.</td></tr></tbody></table>

### Reviewing Results

After each run, a panel appears next to the content showing your results. You'll see checks you've passed, such as "No broken links," and suggestions for improvements, such as "Add concrete first-party insights," "Add a source link for this third-party claim," or "Shorten long paragraphs."

For each suggestion, you'll see:

* What was flagged: the specific section or element.
* Why it was flagged: the check it didn't meet.
* What to improve: concrete suggestions.

### Applying Suggestions

When you click **Apply** on selected suggestions, AirOps uses your content, the flagged checks, and the suggested improvements to rewrite the relevant sections.

You review the result before it's saved. Nothing changes without your approval.

### Task Usage

Each check that runs on a piece of content counts as 1 task from your plan's existing task pool.

Your task usage depends on how many outputs you score and which checks run for each output.

### Best Practices

Use recurring suggestions to improve your system, not just individual pieces. If you find yourself applying the same suggestion every time, that's a signal to go upstream:

* Add it as a writing rule in your Brand Kit so your workflows produce better content from the start.
* Upload first-party research or data to a Knowledge Base so your content has original insights built in.
* Adjust your workflow prompts to address the pattern at the source.

Content Review creates a flywheel: checks surface what to improve, you apply fixes to individual content, and you feed those learnings back into your Brand Kit, Knowledge Bases, and workflows so the next batch comes out better.


---

# 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.airops.com/actions/grids/run-content-review-on-your-output.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.
