cs-aeo

Answer Engine Optimization (AEO) specialist agent. Use when content needs to be optimized for citation by AI language models (ChatGPT, Perplexity, Claude, Gemini, Mistral) rather than for traditional search rankings. Orchestrates the aeo skill — runs E-E-A-T audit, generates optimization variants in conservative/balanced/aggressive modes, and maintains a citation tracking ledger. Industry-aware (8 industries with calibrated thresholds). Distinguishes AEO from SEO and refuses to optimize for one channel at the expense of the other. Voice — pragmatic content strategist; respects existing SEO investments; insists on real first-person evidence over fabricated authority signals.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, largely actionable agent skill body with strong progressive disclosure and clear sequencing. It is held back from the top band mainly by a verbose Voice section and the absence of executable tool-invocation examples and retry feedback loops.

Suggestions

Trim the Voice section from seven blockquotes to 2-3 representative examples to recover token budget.

Add concrete executable invocations (e.g. `python aeo_audit.py <url>` and `python aeo_optimizer.py --mode balanced`) so the tool references become copy-paste ready.

Remove the hard-coded "Version: 2.7.3" line or relocate it to a labeled deprecated/changelog section to avoid time-sensitive clutter.

Dimension	Reasoning	Score
Conciseness	Mostly lean with tight hard-rules and bullets, but the Voice section carries seven long blockquote examples that could be pruned, and the trailing "Version: 2.7.3" is time-sensitive clutter not placed in a deprecated/old-patterns section.	4 / 5
Actionability	Names concrete tools, thresholds (85+ vs 70 default), modes, and ledger actions (add/list/report/export), but never shows an executable invocation (e.g. `python aeo_audit.py <url>`) — a minor gap for an orchestration skill.	4 / 5
Workflow Clarity	Clear intake→audit→optimize→track sequence with gating rules ("Audit before optimize", refuse YMYL below threshold), but lacks explicit validate→fix→retry feedback loops for error recovery.	4 / 5
Progressive Disclosure	Well-organized overview with one-level-deep, clearly signaled references (three reference docs each annotated with source counts) and a Skill Integration section pointing to the underlying skill and Python tools.	5 / 5
	Total	17 / 20 Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that cleanly states both purpose and trigger conditions, names concrete actions, and explicitly carves out a niche distinct from SEO. The only gap is slightly thinner coverage of layperson synonyms for AEO.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "runs E-E-A-T audit", "generates optimization variants in conservative/balanced/aggressive modes", "maintains a citation tracking ledger", "distinguishes AEO from SEO" — giving comprehensive coverage of capabilities.	5 / 5
Completeness	Explicitly answers both what ("Orchestrates the aeo skill — runs E-E-A-T audit...") and when ("Use when content needs to be optimized for citation by AI language models... rather than for traditional search rankings") with concrete trigger phrases.	5 / 5
Trigger Term Quality	Good natural-term coverage ("content needs to be optimized for citation by AI language models" plus all five LLM names and the SEO contrast), but misses common synonyms like "AI search", "AI overviews", or "LLM citations" that users would actually say.	4 / 5
Distinctiveness Conflict Risk	Clear AEO-for-LLM-citation niche with explicit distinctiveness framing ("Distinguishes AEO from SEO and refuses to optimize for one channel at the expense of the other"), minimizing conflict with sibling SEO skills.	5 / 5
	Total	19 / 20 Passed

Validation

87%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
relative_links	Relative link issues: 1 missing, 1 suspicious	Warning

	Total	14 / 16 Passed

Repository: alirezarezvani/claude-skills
Path: .gemini/skills/cs-aeo/SKILL.md
Commit: 19392f7

Reviewed: ~2 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.