CtrlK
BlogDocsLog inGet started
Tessl Logo

seo-technical

Run a comprehensive technical SEO audit covering crawlability, indexability, rendering, site architecture, structured data, page experience, security, and internationalization. Use this skill whenever the user asks about technical SEO, crawl issues, indexing problems, sitemaps, robots.txt, canonical tags, schema markup, page speed, Core Web Vitals, hreflang, redirects, or site-wide search performance. Triggers on technical SEO, site audit, crawlability, indexability, sitemap, robots.txt, canonical, redirect chain, schema, JSON-LD, Core Web Vitals, page speed, hreflang, mobile usability, HTTPS, security headers, render-blocking, JavaScript SEO. Also triggers when a site has indexing problems, traffic drops, or migration concerns, even if 'technical SEO' is not said explicitly.

63

Quality

75%

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 ./skills/seo-technical/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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 an excellent skill description that thoroughly covers what the skill does, when to use it, and includes comprehensive trigger terms. It uses proper third-person voice, lists concrete audit areas, and even accounts for implicit triggers (e.g., traffic drops, migration concerns). The only minor concern is slight verbosity with some redundancy between the 'Use this skill whenever' clause and the 'Triggers on' list, but this doesn't detract from its effectiveness.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and domains: crawlability, indexability, rendering, site architecture, structured data, page experience, security, and internationalization. The description clearly names what the audit covers.

3 / 3

Completeness

Clearly answers both 'what' (run a comprehensive technical SEO audit covering specific areas) and 'when' (explicit 'Use this skill whenever...' clause plus a 'Triggers on' list and even implicit trigger scenarios like traffic drops). Both dimensions are thoroughly addressed.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'technical SEO', 'crawl issues', 'indexing problems', 'sitemaps', 'robots.txt', 'canonical tags', 'schema markup', 'page speed', 'Core Web Vitals', 'hreflang', 'redirects', 'traffic drops', 'migration concerns'. These are highly natural terms that match real user queries.

3 / 3

Distinctiveness Conflict Risk

The skill occupies a clear niche—technical SEO auditing—with highly specific trigger terms like 'robots.txt', 'canonical tags', 'hreflang', 'JSON-LD', and 'redirect chain' that are unlikely to conflict with other skills. The domain is well-defined and distinct.

3 / 3

Total

12

/

12

Passed

Implementation

50%

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

This is a well-structured instructional skill that provides a comprehensive framework for technical SEO auditing. Its main strengths are the clear 6-layer mental model, the prioritization guidance, and the failure patterns section. Its main weaknesses are the lack of concrete executable examples (no curl commands, no code snippets for validation, no specific tool configurations) and missing validation checkpoints in the workflow, particularly for high-risk migration scenarios.

Suggestions

Add concrete executable examples: curl commands for checking robots.txt/sitemaps, example validation scripts, or specific tool commands (e.g., Screaming Frog CLI, Lighthouse CLI) to make the workflow actionable rather than directional.

Add explicit validation gates in the workflow, especially for migrations: e.g., 'Verify redirect map covers 100% of indexed URLs before proceeding' and 'Post-migration: re-crawl within 24h and compare indexed URL counts.'

Provide the referenced bundle files (audit-template.md and migration-checklist.md) so the progressive disclosure actually works, or inline a minimal version of the audit template.

In the 6-layer framework, add specific check commands or methods for each item (e.g., 'curl -I https://example.com/robots.txt' to verify status, 'grep noindex' on rendered HTML) to move from checklist to executable guidance.

DimensionReasoningScore

Conciseness

The content is mostly efficient and well-organized, but includes some sections that could be tightened. The 'When NOT to use' section and 'Required inputs' section add useful context but the 6-layer framework descriptions contain some explanatory text that Claude would already know (e.g., 'Canonicals are hints, not directives'). Overall reasonably lean for the breadth of the topic.

2 / 3

Actionability

The skill provides a clear checklist-style framework and workflow steps, but lacks concrete executable commands, code snippets, or tool-specific instructions. Guidance like 'Use a crawler to enumerate URLs' and 'test with the URL Inspection tool' is directional rather than executable. No specific curl commands, script examples, or tool configurations are provided.

2 / 3

Workflow Clarity

The 7-step workflow is clearly sequenced and logically ordered, but lacks explicit validation checkpoints and feedback loops. For an audit involving potentially destructive actions (migrations, redirect maps), there's no 'validate then proceed' pattern. The cross-reference step (step 5) is a partial validation but isn't framed as a gate. Missing verification steps for migration scenarios cap this at 2.

2 / 3

Progressive Disclosure

The skill references two external files (audit-template.md and migration-checklist.md) which is good progressive disclosure design, and the 'When NOT to use' section cross-references other skills. However, no bundle files were provided, so the referenced files don't actually exist. The 6-layer framework is detailed inline which is appropriate for the overview, but the failure patterns and output format sections could potentially be split out.

2 / 3

Total

8

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
rampstackco/claude-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.