CtrlK
BlogDocsLog inGet started
Tessl Logo

geo-fundamentals

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

44

Quality

46%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/geo-fundamentals/SKILL.md

The canonical home for this skill is geo-fundamentals in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

43%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 well-structured reference material with a useful checklist and an audit script, but it lacks a sequenced workflow and inlines content that could live in reference files. It reads more as a cheat-sheet than an actionable procedure.

Suggestions

Convert the numbered sections into an explicit sequenced workflow (audit -> optimize content -> add schema -> verify crawler access -> measure) with validation checkpoints.

Move the large reference tables (RAG retrieval factors, engine landscape) into a references/ file and keep SKILL.md as a concise overview with one-level-deep links.

Add a short executable example for the checklist (e.g. a JSON-LD FAQPage schema snippet) to lift actionability beyond descriptive guidance.

DimensionReasoningScore

Conciseness

The dense table format is mostly efficient, but 'What is GEO' and 'SEO vs GEO' sections explain basics Claude largely already knows and could be trimmed.

3 / 5

Actionability

The checklist provides concrete items (e.g. 'Article schema with dates', 'Question-based titles') and one script command, but the bulk is descriptive reference material with no code examples.

3 / 5

Workflow Clarity

Sections are numbered 1-9 but there is no sequenced workflow or validation checkpoints; it reads as topical reference rather than a guided process.

2 / 5

Progressive Disclosure

Sections are clearly organized and the script reference (scripts/geo_checker.py, a real file) is properly signaled, but substantial reference content (RAG factors, engine landscape) is inlined rather than split into separate files.

3 / 5

Total

11

/

20

Passed

Description

48%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 clearly identifies the domain and target platforms but lacks concrete actions and any 'when to use' guidance. Adding a 'Use when...' clause and 1-2 specific actions would materially raise the score.

Suggestions

Add a 'Use when...' clause with concrete triggers, e.g. 'Use when optimizing content for AI search engines or when the user mentions GEO, AI citations, or ChatGPT/Perplexity visibility.'

Replace the generic 'Optimization' with 1-2 concrete actions, e.g. 'Audits content for AI citation readiness and recommends entity, schema, and freshness improvements.'

Include common synonyms such as 'AI search', 'LLM answers', and 'AI citations' to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

Names the GEO domain and three specific platforms (ChatGPT, Claude, Perplexity), but the only action verb is the generic 'Optimization' with no concrete actions listed.

2 / 5

Completeness

It clearly states what the skill does ('Generative Engine Optimization for AI search engines') but includes no 'Use when...' clause or explicit trigger guidance, which caps completeness at 3 per the guidelines.

3 / 5

Trigger Term Quality

The named engines (ChatGPT, Claude, Perplexity) are natural trigger terms, but common variations like 'AI search', 'LLM answers', or 'AI citations' are missing.

3 / 5

Distinctiveness Conflict Risk

GEO is a distinct niche with specific engine triggers; minor overlap risk only with closely related SEO skills.

4 / 5

Total

12

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.