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 skill description with excellent trigger term coverage and completeness, including both positive triggers and explicit exclusions. The main weakness is that the 'what' portion could be more specific about concrete actions rather than high-level goals. The description effectively distinguishes itself from technical/coding skills through its exclusion clause.

Suggestions

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

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 a helpful '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 strategy guide or ebook than a lean, actionable skill file for Claude. While it contains useful frameworks and some concrete guidance (MCP setup, template structures), it is severely bloated with marketing knowledge, tool pricing, conversion benchmarks, and strategic rationale that Claude either already knows or that should be in separate reference files. The lack of progressive disclosure means the entire ~400-line document loads into context for every SEO-related query.

Suggestions

Reduce the main SKILL.md to a concise overview (~100 lines) covering the core workflow and decision points, then move 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 marketing content that Claude already knows (e.g., why BOFU converts better than TOFU, what AI Overviews are, platform user counts) and replace with terse directives.

Add explicit validation/feedback loops to the programmatic page generation workflow—e.g., what to do when uniqueness score is below 70%, when pages aren't indexing after 48 hours, or when content scores are below 80.

Replace the AirOps workflow pseudocode and high-level pipeline diagrams with more concrete, executable examples—specific API calls, actual CSV format examples, or real command sequences.

DimensionReasoningScore

Conciseness

This is an extremely long skill (~400+ lines) that includes extensive tables, decision matrices, tool comparisons with pricing, conversion rate benchmarks, and strategic explanations that Claude could infer or that constitute general SEO knowledge. Much of this reads like a comprehensive SEO guide rather than a lean skill file—tool pricing, platform user counts, and marketing strategy rationale are verbose padding.

1 / 3

Actionability

The skill provides some concrete guidance like MCP setup commands, template structures, and workflow patterns, but most content is strategic/conceptual rather than executable. The AirOps workflow is pseudocode, the 'pipeline' is a high-level flow diagram, and many sections describe what to do rather than providing copy-paste-ready commands or code.

2 / 3

Workflow Clarity

Multi-step processes are listed (e.g., keyword research workflow, monthly iteration cycle, acquisition playbook) with reasonable sequencing, but validation checkpoints are largely missing or implicit. The programmatic page generation workflow mentions quality controls but lacks explicit validate-fix-retry feedback loops for when pages fail quality checks or indexing.

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 body 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.