CtrlK
BlogDocsLog inGet started
Tessl Logo

geo-fundamentals

Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).

51

Quality

57%

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 ./.agents/skills/geo-fundamentals/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

55%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.

The body is a well-structured, fairly actionable reference with a real bundled audit script, but it reads as topical reference material rather than a sequenced workflow and includes some concept re-explanation Claude does not need.

Suggestions

Replace the conceptual 'What is GEO' / 'SEO vs GEO' sections with a one-line definition and keep only operational guidance.

Add a short numbered workflow around the checker: run geo_checker.py → review flagged gaps → apply fixes → re-run to confirm.

Include a minimal example robots.txt snippet and one FAQPage schema JSON block so the checklist items are copy-paste ready.

DimensionReasoningScore

Conciseness

The body is mostly compact tables, but sections like 'What is GEO' and 'SEO vs GEO' re-explain concepts Claude already knows, and the closing 'Remember' blockquote is padding.

3 / 5

Actionability

It supplies a runnable command (python scripts/geo_checker.py <project_path>), concrete schema types (Article/Person/FAQPage), named AI crawler user-agents, and checklists; as an instruction-only skill the lack of code snippets is not heavily penalized, though example robots.txt/schema JSON would close the gap.

4 / 5

Workflow Clarity

Content is organized as topical reference sections (1–9), not a sequenced process; there is no audit→fix→re-audit loop or validation checkpoint around the checker script.

2 / 5

Progressive Disclosure

Sections are well organized and the single bundle reference (scripts/geo_checker.py, which exists) is clearly signaled at one level of depth; minor gap is that conceptual reference tables are inlined rather than split out.

4 / 5

Total

13

/

20

Passed

Description

60%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.

The description establishes a distinct, on-trend niche and uses natural engine names, but it lacks concrete action verbs and any 'Use when...' trigger guidance, capping its completeness and specificity.

Suggestions

Add concrete action verbs, e.g. 'Audits and optimizes web content for citations in AI search engines'.

Append an explicit trigger clause: 'Use when the user wants content cited by ChatGPT, Claude, Perplexity, or Gemini, or mentions GEO / AI search optimization.'

Include natural synonyms like 'AI citations' and 'AI answers' alongside the engine names.

DimensionReasoningScore

Specificity

The description names the domain ('Generative Engine Optimization for AI search engines') and lists concrete platforms (ChatGPT, Claude, Perplexity), but offers no concrete action verbs — 'Optimization' is a generic activity label, mirroring the anchor 'Processes PDF files'.

2 / 5

Completeness

It states a clear 'what' (GEO for AI search engines) but provides no 'Use when...' trigger clause; per the guidelines a missing explicit trigger caps completeness at 3.

3 / 5

Trigger Term Quality

'AI search engines' plus the named engines (ChatGPT, Claude, Perplexity) are natural terms users say, but common synonyms like 'AI citations' or 'AI answers' are absent, leaving a few gaps.

4 / 5

Distinctiveness Conflict Risk

AI-search / GEO optimization is a clearly delineated niche with engine-specific triggers, giving minimal overlap with other skills.

5 / 5

Total

14

/

20

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
vudovn/ag-kit
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.