ApiaryActiveLive
Try: pause · settings · learn · wipe
← Community / Reading Room
AA
craft · 2 min read

Ask AI to Identify Places Where a Draft Needs an Example

Using artificial intelligence to audit your drafts for clarity can reveal gaps where abstract concepts leave the reader guessing. Instead of asking the AI to…

AI-assisted practical guide. Examples are hypothetical; these are proposed editorial methods, not reported research results.

Using artificial intelligence to audit your drafts for clarity can reveal gaps where abstract concepts leave the reader guessing. Instead of asking the AI to write the examples for you, which often results in generic filler, ask it to identify specific locations where an illustration would strengthen the argument. This approach treats the AI as an editorial consultant rather than a ghostwriter, with the aim of checking that the final examples remain authentic to your specific expertise and voice.

Prompting for Editorial Gaps

To get the most useful feedback, instruct the AI to look for theoretical claims or complex instructions that lack a concrete application. You might suggest that the AI flag any sentence that describes a process without showing a result. A useful prompt for this task is: Analyze the following text and identify three to five specific paragraphs where the reader might struggle to visualize the concept. For each instance, explain why an example is needed and suggest the type of example that would best clarify the point.

Hypothetical example

Imagine you have written a guide on professional etiquette but the section on conflict resolution is too vague. You feed the text into the AI, and it returns a suggestion like this: In the third paragraph, you mention that employees should use neutral language during disputes. This is a theoretical instruction. You should insert a brief example here showing a transition from an accusatory phrase to a neutral one. For instance, instead of saying You always miss deadlines, a neutral example would be I noticed the report was submitted two days late.

Refining and Verifying the Draft

When the AI flags a section, treat the suggestion as a proposal. Evaluate whether the addition of an example actually improves the flow or if it creates unnecessary clutter. In difficult cases where the topic is highly technical, the AI might suggest examples that are too simplistic. In these instances, you should override the suggestion and craft a nuanced scenario that reflects real-world complexity. Once you have integrated your examples, perform a final check by reading the passage aloud. Ensure the example serves as a bridge to the next point rather than a detour. The final deliverable is successful if a reader unfamiliar with the topic can grasp the core concept through the example without needing to refer back to the theoretical explanation.

Related guides

Frequently asked
What is Ask AI to Identify Places Where a Draft Needs an Example about?
Using artificial intelligence to audit your drafts for clarity can reveal gaps where abstract concepts leave the reader guessing. Instead of asking the AI to…
What should you know about prompting for Editorial Gaps?
To get the most useful feedback, instruct the AI to look for theoretical claims or complex instructions that lack a concrete application. You might suggest that the AI flag any sentence that describes a process without showing a result. A useful prompt for this task is: Analyze the following text and identify three…
What should you know about hypothetical example?
Imagine you have written a guide on professional etiquette but the section on conflict resolution is too vague. You feed the text into the AI, and it returns a suggestion like this: In the third paragraph, you mention that employees should use neutral language during disputes. This is a theoretical instruction. You…
What should you know about refining and Verifying the Draft?
When the AI flags a section, treat the suggestion as a proposal. Evaluate whether the addition of an example actually improves the flow or if it creates unnecessary clutter. In difficult cases where the topic is highly technical, the AI might suggest examples that are too simplistic. In these instances, you should…
References & sources
  1. Apiary Reading Room — Open, cited knowledge base — funded to keep bee & practical research free.
From the Apiary Reading Room. Opinion & editorial — not financial advice. We don't overclaim.
More from the Reading Room