SkillAgentSearch skills...

aeo

This skill should be used when the user asks to "build an AEO strategy", "improve AI search visibility", "track buyer prompts", "analyze AI citations", or "plan content for answer engines".

Install / Use

npx skills add fcakyon/claude-codex-settings --skill aeo

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

86/100

Supported Platforms

Universal

Tags

Our assessment of aeo

aeo scores 86/100 on our quality scale, 2436th of 4,648 Development & Engineering skills we index.

Its SKILL.md is 15 KB long, well organised into 11 sections and no code examples: a thorough specification that gives an agent plenty to work with.

With 1,153 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
13/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so aeo is actively maintained.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.

Automated pattern scan on 2026-11-09. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

aeo compared with similar skills

All 4 of these similar skills score higher than aeo; compare them before choosing.

SkillScoreStarsUpdatedFormat
aeo (this skill)by fcakyon861.2k45d agoSKILL.md
taste-skillby Leonxlnx100112.0k1d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10070.5ktodayCLAUDE.md
claude-howtoby luongnv8910046.7k5d agoCLAUDE.md
lobehubby lobehub10084.4ktodayMCP Server

Frequently asked questions

How do I install aeo?
Run npx skills add fcakyon/claude-codex-settings --skill aeo. The install tabs above show the steps for each supported agent.
Which AI agents does aeo work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is aeo safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is aeo still maintained?
The repository was last updated about 2 months ago, so aeo is actively maintained.

name: aeo description: This skill should be used when the user asks to "build an AEO strategy", "improve AI search visibility", "track buyer prompts", "analyze AI citations", or "plan content for answer engines". Apply an evidence-led answer engine optimization (AEO/GEO) feedback loop to any product or service, prioritizing discovery by buyers who have not heard of it.

Answer engine optimization

Help a product become discoverable and accurately recommended when prospective customers ask AI assistants buying questions. Adapt to software, physical goods, consumer products, services, marketplaces, and local businesses. Default to acquiring people who have not heard of the product. Success means the answer introduces the product or cites useful owned content without the buyer naming it.

Use the loop: buyer question → observed answer and sources → diagnosed gap → page or source improvement → repeated measurement → customer outcome.

Scope and evidence

Match the requested work: strategy, baseline audit, prompt set, source analysis, content brief, or performance review. Keep explicitly requested branded accuracy or conversion work scoped to that purpose. Use existing product material, research, analytics, and monitoring exports before requesting missing inputs. Ask only for information that changes the next decision. With no analytics or answer-engine access, produce a proposed measurement plan and label assumptions. Never fill missing observations with invented results.

Treat case-study growth figures as hypotheses to investigate, not expected returns. Neither a fixed prompt count nor a particular engine's traffic share transfers between products. AEO guidance alone does not authorize publishing, outreach, paid monitoring, or recurring jobs.

1. Define the buying context

Identify the product, canonical domain, brand aliases, category, target markets and languages, audience, substitutes, differentiators with evidence, buying constraints, and desired customer action. Distinguish the buyer, user, and decision-maker where useful. For consumer or local purchases, use the shopper's situation, location, and constraints instead of inventing enterprise personas.

Define one primary outcome, such as a paid order, qualified inquiry, booking, or activated trial. Keep intermediate events such as page views and signups separate. Record the normal purchase or sales lag and the available attribution window.

2. Build a prompt portfolio

Start with observed language from support questions, sales conversations, reviews, on-site search, search queries, and customer research. Separate observed questions from generated candidates. Group prompts by audience or purchase situation, journey stage, topic, use case, constraints, market, and language.

Build the acquisition portfolio around problems, desired outcomes, categories, constraints, and alternatives. A buyer can be ready to purchase without knowing the product name. Useful patterns include:

  • What is the best way to achieve an outcome under a specific constraint?
  • Which product category fits a particular audience or situation?
  • How do two approaches compare for a concrete use case?
  • Which options meet a requirement, budget, location, or compatibility need?
  • What tradeoffs, costs, proof, or limitations should a buyer check?

Use natural customer language and separate these cohorts:

| Cohort | Buyer knowledge and prompt | Purpose | | --- | --- | --- | | Problem or category discovery | Does not know the target product. Asks how to solve a problem or find a suitable option. | Measure whether answers introduce the product without naming it in the prompt | | Competitor alternatives | Knows an alternative. Asks for alternatives to it without naming the target product. | Measure acquisition from competitor-aware buyers, reported separately from category discovery | | Branded evaluation | Already knows the target product. Names it to ask about price, support, suitability, or comparisons. | Check accuracy and support conversion, excluded from acquisition visibility rates |

Exclude the target brand, aliases, domain, and unique product names from acquisition prompts and any supplied conversation context. Use fresh conversations without target-brand seeding. Competitor names, compatible platforms, and subjects such as a movie title can be natural buying context. Include poor-fit cases to check recommendation accuracy, without rewarding irrelevant recommendations.

Distinguish two acquisition paths: a solution question can lead to a product recommendation, while a contextual question can lead to a useful owned guide where the reader discovers the product. A guide citation is not a product recommendation. Map each acquisition prompt to its intended path and next customer action.

Choose coverage based on distinct buying decisions and collection cost. Deduplicate paraphrases that add no new intent. Keep a stable core for trend comparisons and a separate exploratory set for new questions. Version additions and removals so expanding coverage cannot masquerade as a visibility change.

3. Prioritize channels and collect a baseline

Review available referrals, conversions, customer acquisition surveys, and customer research. Prioritize engines that bring relevant customers or that the audience demonstrably uses. With no channel evidence, run a small discovery sample across plausible engines before committing the budget.

Estimate cost as prompts × engines × repetitions × collection frequency, plus research and maintenance. Start within the user's budget. Use existing exports or a small manual sample before suggesting a paid stack. Automated collection must use supported access and respect provider limits.

For each observation, retain the exact prompt, timestamp, engine and model or mode when visible, locale, relevant account or personalization context, answer evidence, brand mentions, explicit recommendations, and cited URLs. Do not store credentials or unnecessary customer identifiers. Record failed runs as failures, not brand absences.

Keep collection settings consistent within each cohort. Repeat enough observations to expose variability, with the sample size stated. Report API output as API output, not proof of what the consumer search interface shows. A web search about an engine is not an observation of that engine's answer.

4. Check whether the relevant content is accessible

Before commissioning content for a gap, inspect the existing page and the path by which the target engine can find it:

  • Status and redirects, robots rules, canonical and index directives, snippet controls, internal links, and sitemap inclusion.
  • The actual body text in fetched HTML and rendered output when available. Check whether access restrictions, rendering, CDN rules, or formatting hide the answer.
  • Whether headings, text, tables, product facts, and applicable structured data accurately describe the visible page.

Keep retrieval, indexing, answer inclusion, and citation as separate findings. A fetched title without body text suggests a retrieval or rendering issue, not proof of partial indexing. A successful browser load or a changed user agent does not prove a provider crawler can access the page. Use index inspection and crawler logs when available, and state exactly what remains unknown.

Check current official documentation before recommending provider-specific crawler changes. Search retrieval and model training controls can differ. Do not broaden access indiscriminately. Google states that its AI Search features use existing SEO foundations and have no additional technical requirements. Do not sell special schema, AI text files, or a writing format as a universal inclusion requirement.

When available, use seo-skills for detailed crawl, index, schema, and architecture work, and google-telemetry for verified Google reporting. Neither plugin is required to apply this methodology. Avoid duplicating their procedures.

5. Diagnose answers and cited sources

For each high-value prompt, compare repeated answers and inspect the cited pages. Separate a brand mention, an explicit recommendation, an owned-page citation, and a third-party citation about the brand. Track competitors and substitutes consistently.

Classify the observed gap before selecting an action:

| Evidence | Candidate action | | --- | --- | | Relevant owned answer exists but cannot be retrieved | Fix access, rendering, discovery, or page structure | | Owned answer is stale, incomplete, or unsupported | Correct the existing page and add verifiable evidence | | No page addresses a distinct buying decision | Research and brief a new page | | Answers repeatedly cite credible external comparisons or listings | Identify a factual contribution, correction, or listing opportunity | | Recommendations misstate suitability or product facts | Clarify the canonical product information and supporting proof | | Visibility grows but qualified customer actions do not | Review audience fit, landing experience, offer, and measurement |

Read sources before inferring why they appear. Citation frequency is an observation, not proof of authority or a causal ranking factor. Missing citations do not prove that a source was unused. Assess the source's audience, evidence, freshness, commercial relationship, and relevance. Do not propose fake reviews, undisclosed endorsements, or paid links presented as editorial citations.

6. Turn findings into content decisions

Review both prompts where the product appears and valuable prompts where it does not. A winning prompt may reveal a reusable strength or an already-satisfied need. Do not automatically turn every winning prompt into another article.

Prefer correcting, merging, or extending an existing relevant page before adding a competing page. Match the format to the buying question: product details, category guidance, comparison, tutorial, evidence report, pricing explanation, compatibility guide, or local service information. A blog post is only one option.

Research audience questions, cited sources, alternatives, and current facts before drafting. Deep-research tools are optional. Verify their claims against underlying sources. Plan original evidence the team can supply, such as a reproducible test, documented experience, demonstration, or measured result. Do not invent product capabilities, reviews, benchmarks, or competitor weaknesses.

Each brief should state the audience, buying question, evidence of the gap, target page or proposed URL, direct answer, supporting proof, relevant tradeoffs, internal links, next customer action, owner, and measurement plan. Use useful headings and readable content for buyers. Keep claims accurate even when quoted out of context. Do not prescribe arbitrary word counts or copy prompts verbatim into titles without checking intent.

Rank actions by buyer relevance, outcome proximity, evidence strength, gap size, effort, and dependency. State uncertainty rather than hiding it behind a precise score. Fix access blockers first for the pages they affect. Assign research, fact checking, drafting, and review to available owners, whether in-house or external.

7. Measure outcomes and repeat

Keep three layers of measurement distinct:

  • Visibility: unprompted mention, relevant recommendation, and owned-content citation rates for each acquisition cohort and engine. Report branded answer accuracy separately.
  • Visits and behavior: identifiable AI referrals, landing pages, engaged visits, and the defined conversion events.
  • Customer outcomes: qualified inquiries, purchases, paid customers, or another agreed business result after the normal lag.

For each rate, state the numerator, denominator, period, engine, and cohort. For example, acquisition mention rate is successful observations mentioning the target brand divided by all successful observations in the same target-brand-free cohort. Never count branded eva

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars1.2k
CategoryDevelopment
Updated1mo ago
Forks110

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions