CtrlK
BlogDocsLog inGet started
Tessl Logo

ai-seo

When the user wants to build programmatic SEO with AI, create competitor alternative pages, optimize for AI Overviews, or scale content production. Also use when the user mentions 'SEO,' 'programmatic SEO,' 'AI content,' 'competitor alternative pages,' 'AI Overviews,' 'search optimization,' 'DataForSEO,' 'content at scale,' 'keyword strategy,' or 'organic traffic.' This skill covers AI-powered SEO strategy from keyword research through programmatic page generation. Do NOT use for technical implementation, code review, or software architecture.

53

Quality

58%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./packages/skills-catalog/skills/(gtm)/ai-seo/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

27%

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

This skill reads more like a comprehensive SEO course or blog post than a concise, actionable skill for Claude. Its greatest weakness is extreme verbosity—it explains strategic concepts, market context, and tool comparisons that Claude doesn't need explained, consuming enormous token budget. While it covers the topic thoroughly and includes some useful templates and workflows, the lack of progressive disclosure (everything in one massive file) and the strategic rather than executable nature of most guidance significantly reduce its effectiveness as a skill.

Suggestions

Reduce content by 60-70%: remove explanations of why strategies work (e.g., why BOFU converts higher), tool pricing tables that will become stale, and conceptual explanations Claude already understands. Focus on the decision matrices, templates, and specific commands.

Split into multiple files: move tool comparison tables to TOOLS.md, page templates to TEMPLATES.md, the GEO checklist to GEO.md, and the content brief template to BRIEF_TEMPLATE.md. Keep SKILL.md as a concise overview with clear references.

Make workflows more executable: replace high-level descriptions like 'Research each tool (pricing, features, reviews)' with specific MCP commands or API calls. Add explicit validation gates with concrete pass/fail criteria (e.g., specific commands to check uniqueness scores).

Remove or drastically condense the 'Before Starting' discovery questions section—Claude can determine what to ask contextually without 8 prescribed questions listed upfront.

DimensionReasoningScore

Conciseness

At ~500+ lines, this skill is extremely verbose. It explains concepts Claude already knows (what BOFU/TOFU means, why competitor alternative pages convert higher, what AI Overviews are), includes extensive tool comparison tables with pricing that will quickly become stale, and repeats information across sections. Much of this reads like a blog post or course rather than a concise skill instruction.

1 / 3

Actionability

The skill provides some concrete guidance like MCP setup commands, template structures, and workflow patterns, but most content is strategic advice and frameworks rather than executable instructions. The AirOps workflow is pseudocode, the keyword research workflow describes steps at a high level without specific commands, and many sections describe what to do conceptually rather than providing copy-paste-ready implementations.

2 / 3

Workflow Clarity

Several multi-step workflows are outlined (keyword research workflow, content production pipeline, monthly iteration cycle, acquisition playbook) with reasonable sequencing. However, validation checkpoints are mostly implicit or vague ('quality controls in place,' 'uniqueness score > 70%') without specifying how to actually validate. The programmatic page generation workflow lacks explicit error recovery steps for when pages fail quality checks or indexing.

2 / 3

Progressive Disclosure

This is a monolithic wall of text with no bundle files to reference. All content—tool comparisons, templates, checklists, troubleshooting, examples—is crammed into a single massive file. There are references to related skills at the bottom, but the core content that could easily be split (tool comparison tables, page templates, GEO checklist, content brief template) is all inline, making this overwhelming to parse.

1 / 3

Total

6

/

12

Passed

Description

89%

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

This is a well-structured skill description with strong trigger term coverage and explicit 'when to use' and 'when not to use' guidance. Its main weakness is that the capability descriptions lean toward high-level goals rather than specific concrete actions. The exclusion clause is a nice touch that helps prevent misrouting.

Suggestions

Add more specific concrete actions to improve specificity, e.g., 'Conducts keyword research, generates programmatic page templates, analyzes competitor positioning, creates content briefs for alternative pages, and optimizes content for AI Overview inclusion.'

DimensionReasoningScore

Specificity

The description names the domain (SEO) and mentions some actions like 'build programmatic SEO,' 'create competitor alternative pages,' 'optimize for AI Overviews,' and 'scale content production,' but these are more like high-level goals than concrete, specific actions. It lacks granular actions like 'generate meta tags,' 'analyze keyword gaps,' or 'create page templates.'

2 / 3

Completeness

Clearly answers both 'what' (AI-powered SEO strategy from keyword research through programmatic page generation) and 'when' (explicit trigger terms listed, plus a 'Do NOT use' exclusion clause). The 'Use when' and 'Do NOT use' guidance is explicit and well-structured.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'SEO,' 'programmatic SEO,' 'AI content,' 'competitor alternative pages,' 'AI Overviews,' 'search optimization,' 'DataForSEO,' 'content at scale,' 'keyword strategy,' 'organic traffic.' These are terms users would naturally use when seeking this type of help.

3 / 3

Distinctiveness Conflict Risk

The description carves out a clear niche around programmatic SEO and AI-powered content strategy, and explicitly excludes technical implementation, code review, and software architecture, which reduces conflict risk with development-oriented skills.

3 / 3

Total

11

/

12

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
tech-leads-club/agent-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.