Content and On-Page SEO skill 03 of 13
Search Intent and SERP Analysis SKILL.md
The Search Intent and SERP Analysis skill makes Claude, Codex or another AI agent read the live results for a query before anyone writes a word. It records the top results and every SERP feature, classifies content type, format, angle and depth, names the dominant intent with counts, separates what every page covers from the gaps nobody fills, and recommends the exact page type to build.
search-intent-serp-analysis/SKILL.md, version 1.0.0, 1,298 words.
By Afeez Adebayo, Marketing, SEO & Growth Expert with 10+ years of experience.
Created 10 October 2026. Updated 10 October 2026. Free to use under CC BY 4.0.
The results page is Google's current answer to the question "what do people searching this want?" Before writing or fixing a page, read that answer. A brilliant guide won't rank for a query where Google shows product listings, and a sales page won't rank where it shows how-to articles.
This skill reads the live results for a query, describes the intent and the format that wins, and says what a page must offer to compete.
Operating principles
- The results are the evidence. Describe what ranks now, not what you think should rank.
- Intent has four layers: the goal (learn, compare, buy, go somewhere), the content type, the format and the angle.
- Mixed results mean mixed intent. When Google shows several types, decide which slice you can serve best.
- Location, language and device change results. Check the market you actually target.
- Match the intent, then beat the results. Matching gets you considered; being clearly more useful gets you chosen.
When to use, and when not to
Use it before writing or rewriting any page, when a good page doesn't rank, when choosing between a blog post and a landing page, when results changed after an update, and when deciding whether a keyword is worth targeting at all.
Don't use it to build a full keyword list (keyword-research) or to plan a whole topic (topical-map).
Inputs to ask for, in one message
- The query or queries, and the target country, language and device.
- The page you want to rank, if it exists.
- Your business type and what you can realistically publish (a guide, a tool, a product page, a comparison).
- Screenshots or exports of the results if the agent can't search the target market itself.
Raw SKILL.md file
This is the exact file agents read, including the credit header and licence notice. Save it as search-intent-serp-analysis/SKILL.md.
--- name: search-intent-serp-analysis description: "Work out what a searcher wants from a query by reading the live results: dominant and mixed intent, content type and format, angle, depth, freshness, SERP features (AI Overviews, featured snippets, People also ask, video, local pack, shopping), who ranks and why, and what a page must offer to compete, turned into a clear page recommendation. Use whenever someone asks what Google wants for a keyword, why a page doesn't rank despite good content, which content type to create, whether to target a query with a blog post or a product page, or how to analyse the SERP." license: CC-BY-4.0 metadata: author: Afeez Adebayo author_url: https://afeezadebayo.com author_linkedin: https://www.linkedin.com/in/afeez-adebayo/ author_x: https://x.com/za_icon source: https://afeezadebayo.com/skills-md/marketing/content-seo/search-intent-serp-analysis/ category: marketing subcategory: content-seo version: "1.0.0" created: "2026-10-10" updated: "2026-10-10" --- # Search Intent and SERP Analysis The results page is Google's current answer to the question "what do people searching this want?" Before writing or fixing a page, read that answer. A brilliant guide won't rank for a query where Google shows product listings, and a sales page won't rank where it shows how-to articles. This skill reads the live results for a query, describes the intent and the format that wins, and says what a page must offer to compete. ## Operating principles 1. **The results are the evidence.** Describe what ranks now, not what you think should rank. 2. **Intent has four layers:** the goal (learn, compare, buy, go somewhere), the content type, the format and the angle. 3. **Mixed results mean mixed intent.** When Google shows several types, decide which slice you can serve best. 4. **Location, language and device change results.** Check the market you actually target. 5. **Match the intent, then beat the results.** Matching gets you considered; being clearly more useful gets you chosen. ## When to use, and when not to Use it before writing or rewriting any page, when a good page doesn't rank, when choosing between a blog post and a landing page, when results changed after an update, and when deciding whether a keyword is worth targeting at all. Don't use it to build a full keyword list (`keyword-research`) or to plan a whole topic (`topical-map`). ## Inputs to ask for, in one message 1. The query or queries, and the target country, language and device. 2. The page you want to rank, if it exists. 3. Your business type and what you can realistically publish (a guide, a tool, a product page, a comparison). 4. Screenshots or exports of the results if the agent can't search the target market itself. ## Workflow ### Step 1. Capture the results Record the top 10 organic results and every SERP feature in order: AI Overview, featured snippet, People also ask, video, images, local pack, shopping, news, forums, knowledge panel. Note the date, country and device. ### Step 2. Classify each result | Field | Examples | |---|---| | Site type | Brand, publisher, marketplace, forum, government, tool | | Content type | Guide, listicle, comparison, product or category page, tool, template, video | | Format | Steps, table, checklist, long-form, calculator | | Angle | For beginners, current year, cheapest, best for a use case, by an expert | | Depth | Word count range, number of subtopics covered | | Freshness | Published or updated date | ### Step 3. Name the dominant intent State the share of results by content type, for example "7 of 10 are comparison listicles; 2 are vendor pages; 1 is a forum thread". The largest group is the dominant intent; a strong second group is a secondary intent. ### Step 4. Read the SERP features | Feature | What it tells you | |---|---| | AI Overview | Google answers part of the query directly; aim to be cited and to offer what the summary can't | | Featured snippet | A short, direct answer format wins: a definition, list or table | | People also ask | Subquestions the page should answer | | Video results | Searchers want to see the task done | | Local pack | Local intent; a location page or Business Profile matters | | Shopping or product grids | Transactional intent; category and product pages compete | | Forum results | Searchers want first-hand experience and opinions | ### Step 5. Find the common ground and the gaps List what most top pages cover (the table stakes) and what few or none cover well: original data, worked examples, current prices, screenshots, expert view, a tool or template. ### Step 6. Check who ranks Note the type and strength of ranking sites. If the top results are all large brands with strong links, the query may be a long-term target; if forums and small sites rank, there is room for a better page. ### Step 7. Recommend the page State the content type, format, angle, sections that must be covered, the gap to fill, the SERP features to target and whether an existing page fits or a new one is needed. ## Intent shifts Results change. Re-check intent for important queries every few months and after core updates. A query that showed guides last year may now show tools or forums, and the page needs to change with it. ## Worked example A project management SaaS wanted to rank its feature page for "gantt chart template". The results in the UK showed 8 template downloads (spreadsheets and printable files), 1 video and 1 tool page; People also ask asked how to make a gantt chart in Excel and Google Sheets. The feature page didn't match. The recommendation: a free downloadable template page with Excel and Google Sheets versions, a short how-to with screenshots, a video, and a clear link to the product for teams that outgrow a spreadsheet. The feature page stayed focused on product queries. ## Output format ``` # SERP analysis: "<query>", <country>, <device>, <date> ## Dominant intent and secondary intent ## SERP features in order ## Top 10 results | # | URL | Site type | Content type | Format | Angle | Depth | Updated | ## Table stakes (what most pages cover) ## Gaps (what you can offer that others don't) ## Recommendation (page type, format, angle, sections, features to target, existing or new page) ``` ## Reading mixed and unusual results | Pattern in the results | What it usually means | Recommendation | |---|---|---| | Guides and product pages split evenly | Mixed intent: learn and buy | Choose the slice you serve best; link the other page type | | Forums and Reddit threads high up | Searchers want first-hand experience | Add real experience, opinions and specifics | | Mostly big brands | High trust or authority bar | Long-term target; win related long-tail first | | Very recent dates everywhere | Freshness matters | Plan a review schedule and dated updates | | Tools and calculators | Searchers want to do, not read | Build a tool or template, with explanation | | Video carousel near the top | Visual demonstration helps | Add a video and video markup | | Local pack | Local intent | Location pages and Business Profile, not a blog post | ## Edge cases and judgement calls | Situation | What to do | |---|---| | Results differ by device | Analyse the device most of your audience uses; note the difference | | Results differ by country | Run the analysis per target market | | Personalised or logged-in results | Use a clean browser profile or a tool that fetches neutral results | | Query is ambiguous (several meanings) | Identify which meaning dominates; don't target a meaning Google rarely shows | | AI Overview answers the question fully | Aim to be cited, and offer what a summary can't: tools, data, depth | ## Handoffs to related skills - Writing the brief from the analysis: `content-brief` - Fixing an existing page that mismatches intent: `on-page-seo` - Writing titles that match intent: `title-tags-meta-descriptions` - Intent shift on older pages: `content-refresh` - AI Overview and AI Mode specifics: the AEO & GEO `ai-overviews-ai-mode` skill ## Quality bar: what an excellent analysis includes - Intent stated with counts from real results, with date, country and device. - Every SERP feature recorded with what it implies. - Table stakes separated from real gaps. - A recommendation specific enough to brief a writer today. ## Common mistakes - Writing a blog post for a query that shows product pages, or the reverse. - Checking results in the wrong country or while logged in with personal history. - Copying the structure of the top result instead of improving on it. - Ignoring forum results as a sign that people want first-hand experience. - Treating intent as fixed forever. ## Questions to ask before you recommend a page - Which market and device matter most? - Can the business produce the format that ranks (a tool, a template, original data)? - Is there an existing page that already fits the intent? ## Self-check before you answer - Did I base intent on the actual results, with counts? - Did I record SERP features and what each implies? - Did I separate table stakes from real gaps? - Is the recommendation specific enough to brief a writer? ## Official documentation - How Google Search works: https://developers.google.com/search/docs/fundamentals/how-search-works - Creating helpful, reliable, people-first content: https://developers.google.com/search/docs/fundamentals/creating-helpful-content - AI features and your website: https://developers.google.com/search/docs/appearance/ai-features - Featured snippets and your website: https://developers.google.com/search/docs/appearance/featured-snippets - Search Quality Rater Guidelines (needs met and intent): https://guidelines.raterhub.com/searchqualityevaluatorguidelines.pdf --- Created by Afeez Adebayo, Marketing, SEO & Growth Expert Website: https://afeezadebayo.com LinkedIn: https://www.linkedin.com/in/afeez-adebayo/ X: https://x.com/za_icon Source: https://afeezadebayo.com/skills-md/marketing/content-seo/search-intent-serp-analysis/ Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). You may copy, share and adapt this skill, including for commercial use, as long as you credit Afeez Adebayo and link to the source URL above. Keep this notice in any copy or adapted version.
Workflow
Step 1. Capture the results
Record the top 10 organic results and every SERP feature in order: AI Overview, featured snippet, People also ask, video, images, local pack, shopping, news, forums, knowledge panel. Note the date, country and device.
Step 2. Classify each result
| Field | Examples |
|---|---|
| Site type | Brand, publisher, marketplace, forum, government, tool |
| Content type | Guide, listicle, comparison, product or category page, tool, template, video |
| Format | Steps, table, checklist, long-form, calculator |
| Angle | For beginners, current year, cheapest, best for a use case, by an expert |
| Depth | Word count range, number of subtopics covered |
| Freshness | Published or updated date |
Step 3. Name the dominant intent
State the share of results by content type, for example "7 of 10 are comparison listicles; 2 are vendor pages; 1 is a forum thread". The largest group is the dominant intent; a strong second group is a secondary intent.
Step 4. Read the SERP features
| Feature | What it tells you |
|---|---|
| AI Overview | Google answers part of the query directly; aim to be cited and to offer what the summary can't |
| Featured snippet | A short, direct answer format wins: a definition, list or table |
| People also ask | Subquestions the page should answer |
| Video results | Searchers want to see the task done |
| Local pack | Local intent; a location page or Business Profile matters |
| Shopping or product grids | Transactional intent; category and product pages compete |
| Forum results | Searchers want first-hand experience and opinions |
Step 5. Find the common ground and the gaps
List what most top pages cover (the table stakes) and what few or none cover well: original data, worked examples, current prices, screenshots, expert view, a tool or template.
Step 6. Check who ranks
Note the type and strength of ranking sites. If the top results are all large brands with strong links, the query may be a long-term target; if forums and small sites rank, there is room for a better page.
Step 7. Recommend the page
State the content type, format, angle, sections that must be covered, the gap to fill, the SERP features to target and whether an existing page fits or a new one is needed.
Intent shifts
Results change. Re-check intent for important queries every few months and after core updates. A query that showed guides last year may now show tools or forums, and the page needs to change with it.
Worked example
A project management SaaS wanted to rank its feature page for "gantt chart template". The results in the UK showed 8 template downloads (spreadsheets and printable files), 1 video and 1 tool page; People also ask asked how to make a gantt chart in Excel and Google Sheets. The feature page didn't match. The recommendation: a free downloadable template page with Excel and Google Sheets versions, a short how-to with screenshots, a video, and a clear link to the product for teams that outgrow a spreadsheet. The feature page stayed focused on product queries.
Output format
# SERP analysis: "<query>", <country>, <device>, <date>
## Dominant intent and secondary intent
## SERP features in order
## Top 10 results
| # | URL | Site type | Content type | Format | Angle | Depth | Updated |
## Table stakes (what most pages cover)
## Gaps (what you can offer that others don't)
## Recommendation (page type, format, angle, sections, features to target, existing or new page)Reading mixed and unusual results
| Pattern in the results | What it usually means | Recommendation |
|---|---|---|
| Guides and product pages split evenly | Mixed intent: learn and buy | Choose the slice you serve best; link the other page type |
| Forums and Reddit threads high up | Searchers want first-hand experience | Add real experience, opinions and specifics |
| Mostly big brands | High trust or authority bar | Long-term target; win related long-tail first |
| Very recent dates everywhere | Freshness matters | Plan a review schedule and dated updates |
| Tools and calculators | Searchers want to do, not read | Build a tool or template, with explanation |
| Video carousel near the top | Visual demonstration helps | Add a video and video markup |
| Local pack | Local intent | Location pages and Business Profile, not a blog post |
Edge cases and judgement calls
| Situation | What to do |
|---|---|
| Results differ by device | Analyse the device most of your audience uses; note the difference |
| Results differ by country | Run the analysis per target market |
| Personalised or logged-in results | Use a clean browser profile or a tool that fetches neutral results |
| Query is ambiguous (several meanings) | Identify which meaning dominates; don't target a meaning Google rarely shows |
| AI Overview answers the question fully | Aim to be cited, and offer what a summary can't: tools, data, depth |
Handoffs to related skills
- Writing the brief from the analysis:
content-brief - Fixing an existing page that mismatches intent:
on-page-seo - Writing titles that match intent:
title-tags-meta-descriptions - Intent shift on older pages:
content-refresh - AI Overview and AI Mode specifics: the AEO & GEO
ai-overviews-ai-modeskill
Quality bar: what an excellent analysis includes
- Intent stated with counts from real results, with date, country and device.
- Every SERP feature recorded with what it implies.
- Table stakes separated from real gaps.
- A recommendation specific enough to brief a writer today.
Common mistakes
- Writing a blog post for a query that shows product pages, or the reverse.
- Checking results in the wrong country or while logged in with personal history.
- Copying the structure of the top result instead of improving on it.
- Ignoring forum results as a sign that people want first-hand experience.
- Treating intent as fixed forever.
Questions to ask before you recommend a page
- Which market and device matter most?
- Can the business produce the format that ranks (a tool, a template, original data)?
- Is there an existing page that already fits the intent?
Self-check before you answer
- Did I base intent on the actual results, with counts?
- Did I record SERP features and what each implies?
- Did I separate table stakes from real gaps?
- Is the recommendation specific enough to brief a writer?
Official documentation
- How Google Search works: https://developers.google.com/search/docs/fundamentals/how-search-works
- Creating helpful, reliable, people-first content: https://developers.google.com/search/docs/fundamentals/creating-helpful-content
- AI features and your website: https://developers.google.com/search/docs/appearance/ai-features
- Featured snippets and your website: https://developers.google.com/search/docs/appearance/featured-snippets
- Search Quality Rater Guidelines (needs met and intent): https://guidelines.raterhub.com/searchqualityevaluatorguidelines.pdf
On this page
- When to use this skill, and when not to
- Example prompts
- Example output
- What the agent needs from you
- How this skill hands off to related skills
- How to run the Search Intent and SERP Analysis skill step by step
- Situations this skill handles
- What makes this skill different
- Practical tips from real projects
- Frequently asked questions
- Changelog
When to use this skill, and when not to
Use it before writing or rewriting any important page, when a well-written page refuses to rank, when choosing between a blog post and a landing page, when results seem to have changed after a Google update, and when deciding whether a keyword is worth targeting at all.
Don’t use it to build a keyword list (use Keyword Research) or to plan a whole topic (use Topical Maps and Content Clusters).
Example prompts
- “What does Google want for gantt chart template in the UK? Should our feature page target it?”
- “Our guide on payroll taxes is well written but stuck at position 14. Analyse the results.”
- “Blog post or comparison page for best CRM for small business?”
- “Compare the SERP for invoice financing in the UK and the US.”
- “Results for our main keyword changed after the update. What shifted?”
Example output
The skill returns a fixed structure. A shortened example for an imaginary site:
# SERP analysis: "gantt chart template", UK, mobile, 10 October 2026 ## Dominant intent Download a free template: 8 of 10 results are template pages (Excel, Google Sheets, printable). ## SERP features People also ask (how to make one in Excel and Sheets), video, images. ## Table stakes Free download, Excel and Sheets versions, preview image. ## Gaps No result shows a filled-in example or explains when to move to software. ## Recommendation New template page, not the feature page: downloads, short how-to with screenshots, video, link to product.
Intent is stated with counts from the actual results, so the recommendation can be checked rather than taken on trust.
What the agent needs from you
The skill asks for the query or queries, the target country, language and device, the page you want to rank if it exists, and what your business can realistically publish: a guide, a tool, a template, a comparison or a product page. If the agent can’t search the target market directly, it asks for screenshots or exports of the results.
How this skill hands off to related skills
The analysis feeds straight into page work. The recommendation becomes a brief through SEO Content Briefs, existing pages are tuned with On-Page SEO Optimisation, and titles are written to match the intent with Title Tags and Meta Descriptions. When results have shifted for older pages, it routes to Content Refresh.
How to run the Search Intent and SERP Analysis skill step by step
- Install the skill as
search-intent-serp-analysis/SKILL.md. - Give the query or queries with the target country, language and device.
- Share the page you want to rank, if it exists, and what your business can realistically publish.
- Let the agent capture the results (or send screenshots if it can’t search your market).
- Read the intent verdict with counts, the SERP features and what each implies.
- Use the recommendation to brief a new page or fix the existing one.
Situations this skill handles
The results page tells you what Google thinks searchers want. The skill reads it for these situations:
| Situation | What the skill does |
|---|---|
| A good page that won’t rank | Checks whether the page type matches the dominant intent |
| Blog post or landing page? | Counts result types and recommends the format that wins |
| Results changed after an update | Compares intent and formats now with before |
| Forums ranking above guides | Recommends adding first-hand experience and specifics |
| Mixed intent query | Names main and secondary intent and the slice you can serve |
| AI Overview answers the question | Recommends aiming to be cited and offering what a summary can’t |
What makes this skill different
Most intent advice stops at four labels: informational, navigational, commercial, transactional. This skill reads four layers from the live results (goal, content type, format and angle), counts them, records every SERP feature and separates what all top pages cover from the gaps nobody fills.
The output is a recommendation specific enough to brief a writer: page type, format, angle, sections, features to target and whether an existing page fits.
Practical tips from real projects
- Check the market you actually target, in a clean browser, on the device your audience uses.
- Count, don’t guess. “7 of 10 are templates” beats “looks like people want templates”.
- Re-check important queries every few months and after core updates.
- Big brands everywhere? Treat the query as long-term and win related long-tail first.
A worked example: a project management company wanted its feature page to rank for “gantt chart template”. Eight of ten UK results were downloadable templates, and People also ask asked how to build one in Excel and Google Sheets. The skill recommended a separate template page with downloads, a short how-to, a video and a link to the product for teams that outgrow spreadsheets, leaving the feature page focused on product searches.
Intent also explains many traffic drops that look like ranking problems. When Google starts showing a different format for a query, a page that used to fit can slide without any technical fault. Re-reading the results is often the fastest diagnosis.
For AI search, the same reading applies: when an AI Overview appears, note which sources it cites and what they offer. Pages that match the intent and add something specific, such as a tool, original data or a clear table, are the ones most often credited.
Save each analysis with its date, country and device. When rankings move months later, comparing old and new results shows whether the intent changed or the page simply lost ground to stronger competitors.
Frequently asked questions
What is search intent?
What the searcher wants to achieve: learn something, compare options, buy, or reach a specific site. In practice it also covers the content type, format and angle that satisfy them, which the live results show.
Why read the results instead of guessing intent?
Because Google has already tested what satisfies searchers for that query. If eight of ten results are templates, a long essay is unlikely to rank, however good it is.
What if the results are mixed?
Mixed results mean mixed intent. The skill names the main and secondary intents and recommends the slice your business can serve best.
Do AI Overviews change the analysis?
Yes. When an AI Overview answers part of the query, the skill notes it and recommends aiming to be cited and offering what a summary can’t, such as tools, data or depth.
How often should I recheck intent?
For important queries, every few months and after core updates. Intent can shift, and pages need to shift with it.
Changelog
- 1.0.0, 10 October 2026: first release.
Use, adapt and share this skill under CC BY 4.0: credit Afeez Adebayo and link to this page.
All Content and On-Page SEO skills
