CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

geo-content-optimizer

Use when the user asks to "optimize for AI citations"; improves citation readiness for ChatGPT, Perplexity, AI Overviews, Gemini, and Claude. Not for structural on-page SEO — use on-page-seo-checker; not for net-new drafting — use content-writer. AI引用优化/GEO优化/AI搜索

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./seo-geo/implement/geo-content-optimizer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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, genuinely actionable instruction skill: a tight five-step workflow with concrete techniques, an explicit Pass/Warn/Fail self-check gate, a keyless runnable probe command, and a clean one-level-deep bundle of reference files. Weaknesses are the long inline measurement-methodology paragraph that duplicates its own referenced protocol file, an implicit rather than explicit fix-and-reverify loop, and a dozen references to parent-repo files that are not shipped in this bundle.

Suggestions

Move the citability-vs-surfacing measurement explanation out of the Data Sources section into references/measurement-protocol.md, keeping only a one-line distinction and the link in SKILL.md.

Make the step-5 feedback loop explicit: after the CORE-EEAT self-check, add 'If any check is Fail: fix the content and re-run the self-check until no Fail is unaddressed'.

Prune or consolidate the parent-repo references (../../../references/*, ../../../scripts/connectors/*, ../../tune/*) that are not part of this skill's bundle, or ship them alongside it, so every link in the body resolves within the distributed skill.

DimensionReasoningScore

Conciseness

Mostly efficient — the five-step workflow is tight and the reference list is one line per item — but the Data Sources section inlines a long measurement-methodology paragraph ('the changes this skill makes... move citability... week-scale and confounded, not minute-level') that duplicates content already living in references/measurement-protocol.md, and the Skill Contract section carries dense handoff/memory boilerplate. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened'); not 4 because that inline methodology paragraph is a clear trim candidate, not 2 because there is no padding that explains concepts Claude already knows.

3 / 5

Actionability

The guidance is concrete and executable: numbered steps name specific techniques ('add standalone 25-50 word definitions, sourced quotable statements... Q&A/tables/lists, specific data, and visible-content-matching FAQ schema'), a copy-paste-ready keyless command is given ('python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/tavily.py" search "<target query>" --answer --limit 10'), and a worked input/output example plus a Measured/User-provided/Estimated labeling rule are included. Not 5 because the actual scoring templates and self-check matrix details are deferred to references rather than shown, leaving minor gaps; not 3 because nothing is pseudocode or vague.

4 / 5

Workflow Clarity

A clear five-step sequence ends in an explicit validation step (CORE-EEAT self-check with Pass/Warn/Fail verdicts plus the slop self-check), reinforced by 'Done when' criteria ('each target AI query has a standalone, quotable answer block... no unaddressed Fail'). Not 5 because the error-recovery loop is only implicit — 'no unaddressed Fail' implies iteration but never says 'if Fail: fix and re-verify' as a spelled-out feedback loop; not 3 because validation checkpoints are explicit, not merely listed.

4 / 5

Progressive Disclosure

The six in-bundle references (instructions-detail.md, geo-optimization-techniques.md, ai-citation-patterns.md, quotable-content-examples.md, medium-github-surfaces.md, ai-overview-recovery.md) all exist, are one level deep, and are clearly signaled with one-line descriptions in the Reference Materials section. However, the body also points at roughly ten parent-repo paths absent from this bundle (../../../references/skill-contract.md, ../../../references/measurement-protocol.md, ../../../scripts/connectors/tavily.py, ../../../references/platforms/*.md, ../../tune/content-quality-auditor/SKILL.md), so several linked navigation targets dangle. This fits anchor 4 ('good structure; most content appropriately placed; references mostly clear; minor organization gaps'); not 5 because of the out-of-bundle dangling references and the inline methodology paragraph that belongs in its referenced file.

4 / 5

Total

15

/

20

Passed

Description

73%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, well-targeted description with an explicit trigger phrase, named engines, bilingual synonyms, and unusually good negative-boundary disambiguation against adjacent skills. The main weakness is that the 'what' stays at the level of a single abstract capability ('improves citation readiness') instead of the concrete optimization techniques the skill actually performs, and English trigger synonyms like 'GEO' are absent.

Suggestions

Replace or augment 'improves citation readiness' with 2-3 concrete actions, e.g. 'adds standalone definitions, sourced quotable statements, and answer-shaped Q&A/FAQ structure that AI engines cite'.

Include the English trigger terms users actually say — 'GEO', 'generative engine optimization', 'AI search optimization' — since only the Chinese equivalents are present.

DimensionReasoningScore

Specificity

The description names the domain precisely ("improves citation readiness for ChatGPT, Perplexity, AI Overviews, Gemini, and Claude") but offers only that one action statement — it never lists concrete techniques like adding definitions, quotable statements, or FAQ schema, which the body actually contains. Anchor 3 ("names domain and 1-2 concrete actions, but not comprehensive") is the best fit; not 4 because several specific actions are missing, not 2 because the domain and at least one real action are stated.

3 / 5

Completeness

Both halves are present: an explicit 'Use when...' clause with a concrete quoted trigger phrase, and a clear 'what' ("improves citation readiness" for the named engines), plus valuable negative boundaries ("Not for structural on-page SEO — use on-page-seo-checker; not for net-new drafting — use content-writer"). Not 5 because the 'what' is a single thin action statement rather than concrete capabilities; not 3 because 'when' is fully explicit, not merely implied.

4 / 5

Trigger Term Quality

The explicit trigger phrase '"optimize for AI citations"' plus five engine names (ChatGPT, Perplexity, AI Overviews, Gemini, Claude) and Chinese synonyms (AI引用优化/GEO优化/AI搜索) give good natural-keyword coverage. Not 5 because common English variations like "GEO", "generative engine optimization", and "AI search optimization" appear only in Chinese, not English; not 3 because coverage goes well beyond a couple of generic keywords.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (AI-citation/GEO readiness, distinct engines listed) and proactively disambiguates the two nearest neighbors by name ("use on-page-seo-checker", "use content-writer"), minimizing wrong-skill triggering. This matches anchor 5 (clear niche, distinct triggers, minimal conflict risk) and exceeds anchor 4's 'minor overlap risk'.

5 / 5

Total

16

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 16 suspicious

Warning

referenced_paths_exist

Referenced path issues: 2 missing, 1 deeper-than-1-level

Warning

Total

12

/

16

Passed

Repository

aaron-he-zhu/aaron-marketing-skills

Path

seo-geo/implement/geo-content-optimizer/SKILL.md

Reviewed

Table of Contents

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.