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.

67

Quality

58%

Does it follow best practices?

Impact

Pending

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

Discovery

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 strong description with excellent trigger term coverage and completeness, including both positive triggers and explicit exclusions. The main weakness is that the 'what' portion describes high-level goals rather than specific concrete actions the skill performs. The description also leads with the 'when' clause rather than the 'what,' which is slightly unconventional but functional.

Suggestions

Add more specific concrete actions to the 'what' portion, e.g., 'Conducts keyword research, generates programmatic page templates, analyzes competitor positioning, creates content briefs for scaled production.'

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 descriptions,' '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 'Use when' triggers and even a 'Do NOT use' exclusion clause). The explicit trigger list and negative boundary make this highly complete.

3 / 3

Trigger Term Quality

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

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 significantly reduces conflict risk with development-oriented skills.

3 / 3

Total

11

/

12

Passed

Implementation

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 lean, actionable skill file for Claude. Its greatest strength is breadth of coverage across programmatic SEO, competitor alternative pages, AI Overviews, and tool selection. However, it is severely over-long, explains many concepts Claude already understands, lacks proper progressive disclosure (everything is inline), and provides more strategic advice than executable, copy-paste-ready guidance.

Suggestions

Reduce the SKILL.md to a concise overview (~100-150 lines) covering the core workflow and decision points, then split detailed content (tool comparison tables, page templates, GEO checklists, keyword strategy details) into separate referenced files like TOOLS.md, TEMPLATES.md, GEO.md, etc.

Remove explanatory content Claude already knows (what BOFU/TOFU means, why competitor pages convert better, what AI Overviews are) and replace with terse decision rules and action steps.

Add explicit validation checkpoints to the programmatic page generation workflow, such as 'After generating batch of 50 pages: run uniqueness check > 70% per page, verify schema markup validates, spot-check 5 pages manually, ONLY THEN publish.'

Replace the AirOps pseudocode workflow and pipeline diagrams with more concrete, executable examples - either actual API calls, CLI commands, or specific tool configurations that Claude can directly use or recommend.

DimensionReasoningScore

Conciseness

At ~400+ lines, this skill is extremely verbose. It explains concepts Claude already knows (what BOFU/TOFU means, why competitor alternative pages convert better, 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 material rather than a lean skill reference.

1 / 3

Actionability

The skill provides some concrete guidance like MCP setup commands, template structures, and workflow patterns, but much of the content is strategic advice and conceptual frameworks rather than executable instructions. The AirOps workflow is pseudocode, the 'pipeline' section is a diagram without executable steps, and many sections describe what to do at a high level without specific commands or code.

2 / 3

Workflow Clarity

Multi-step processes are listed (e.g., keyword research workflow, monthly iteration cycle, agent workflow pattern) with reasonable sequencing, but validation checkpoints are mostly absent or vague. The programmatic page generation workflow lacks explicit validation/feedback loops for catching quality issues before publishing at scale, which is critical for batch content operations.

2 / 3

Progressive Disclosure

This is a monolithic wall of text with 8 major sections all inline. There are no references to separate files for detailed content (tool comparisons, templates, checklists could each be their own file). The 'Related Skills' section at the end references other skills but the core content itself has no progressive disclosure structure - everything is dumped into one massive document.

1 / 3

Total

6

/

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.