CtrlK
BlogDocsLog inGet started
Tessl Logo

geo-fundamentals

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

60

Quality

72%

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

72%

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

The content is highly concise and cleanly organized with a correctly referenced executable script, but it reads as a reference overview rather than a sequenced, fully-actionable workflow with validation checkpoints.

Suggestions

Add a short sequenced "How to run an audit" workflow: run scripts/geo_checker.py, review reported issues, fix the flagged page elements, re-run until the average score passes 60.

Convert the most decision-oriented tables (e.g., AI crawler access) into concrete directive steps or a short runnable checklist Claude can follow.

DimensionReasoningScore

Conciseness

The body is almost entirely compact tables with no filler and no explanation of concepts Claude already knows, matching the lean-and-efficient anchor 3.

3 / 3

Actionability

Concrete specifics are present (named schema types, crawler user-agents, a "< 2.5s" threshold, and a real executable checker command), but most sections are reference/landscape tables rather than direct runnable instruction, fitting the some-concrete-but-incomplete anchor 2.

2 / 3

Workflow Clarity

Content is organized by topic but a GEO audit is not sequenced into explicit steps with validation checkpoints; the checker script could form a validate-fix-retry loop but is not wired into the body, matching the steps-present-checkpoints-missing anchor 2.

2 / 3

Progressive Disclosure

The body is well-organized into numbered sections and references exactly one real, one-level-deep bundle file (scripts/geo_checker.py, which exists and is cited with its command), matching the well-signaled-references anchor 3.

3 / 3

Total

10

/

12

Passed

Description

72%

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 is concise, distinct, and uses natural trigger terms, but it describes the domain rather than concrete skill actions and omits an explicit use-trigger within the description field itself.

Suggestions

Reword the description to lead with concrete actions, e.g. "Audits and optimizes web content for citations in AI search engines (ChatGPT, Claude, Perplexity)"

Append an explicit trigger clause to the description, e.g. ". Use when the user wants content to rank in or be cited by AI-generated answers."

DimensionReasoningScore

Specificity

"Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity)" names the domain and concrete target platforms but lists no concrete actions (e.g., audit, optimize, check citations), placing it above the vague anchor 1 yet short of the multiple-specific-actions anchor 3.

2 / 3

Completeness

It clearly states what the skill covers but the description field itself has no "Use when..." trigger clause (the when guidance lives in the separate when_to_use field), so per the guidelines completeness is capped at 2 rather than reaching the explicit-both anchor 3.

2 / 3

Trigger Term Quality

The terms users naturally say — "AI search engines", "ChatGPT", "Claude", "Perplexity" — are present alongside the field term "Generative Engine Optimization", giving good coverage matching the anchor 3 example.

3 / 3

Distinctiveness Conflict Risk

GEO for AI search engines is a clearly defined niche unlikely to conflict with other skills, matching the clear-niche anchor 3.

3 / 3

Total

10

/

12

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.