CtrlK
BlogDocsLog inGet started
Tessl Logo

site-architecture

Technical SEO - robots.txt, sitemap, meta tags, Core Web Vitals

58

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./skills/site-architecture/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%

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

The body is highly actionable, packed with executable templates, but it is a verbose monolithic reference rather than a sequenced workflow with feedback loops, and it does not split detail into bundle files.

Suggestions

Move the large code-template catalogs (e.g. AI crawler robots rules, structured-data examples) into references/*.md files and link to them from a lean overview to improve progressive_disclosure and conciseness.

Add an explicit sequenced setup workflow with validation checkpoints (e.g. generate robots.txt/sitemap -> validate with robots tester and Rich Results Test -> fix -> submit to Search Console) to lift workflow_clarity toward 3.

Trim the Philosophy section and collapse the redundant robots.txt variants to reduce token overhead.

DimensionReasoningScore

Conciseness

The body is largely lean, copy-paste reference material, but it includes unnecessary philosophy ("Content is king. Architecture is the kingdom.") and triplicate robots.txt variants, matching the score-2 anchor of mostly-efficient with some padding rather than the every-token-earns-its-place bar of 3.

2 / 3

Actionability

The body is dense with fully executable, copy-paste-ready code across robots.txt, Next.js robots.ts/sitemap.ts, meta tags, redirects, security headers, and a breadcrumbs component, matching the score-3 anchor of fully executable specific examples.

3 / 3

Workflow Clarity

Content is organized as a topic catalog with a closing checklist and some verification steps, but there is no sequenced end-to-end workflow with explicit validate-then-fix-then-retry feedback loops for risky config changes, so it sits at score 2 rather than 3.

2 / 3

Progressive Disclosure

Sections are well-organized, but everything lives in one ~930-line monolithic file with no bundle references; the under-50-line simple-skill exemption does not apply, so it matches score 2 (content that should be separate is inline) rather than the one-level-deep reference split of 3.

2 / 3

Total

9

/

12

Passed

Description

72%

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 is specific and uses strong natural trigger terms within a clear technical-SEO niche, but it lacks an explicit "Use when..." clause, capping its completeness at the mid level.

Suggestions

Append an explicit trigger clause, e.g. ". Use when setting up robots.txt, sitemaps, meta tags, or Core Web Vitals / technical SEO" to lift completeness from 2 to 3.

Reframe the topic list as concrete actions (e.g. "Configure robots.txt, generate sitemaps, optimize meta tags, improve Core Web Vitals") to raise specificity toward 3.

DimensionReasoningScore

Specificity

The description "Technical SEO - robots.txt, sitemap, meta tags, Core Web Vitals" names the domain and several concrete topic areas, matching the score-2 anchor "Names domain and some actions, but not comprehensive"; it is a topic list rather than enumerated verbs, so it does not reach the multiple-specific-actions bar of 3.

2 / 3

Completeness

The description states what the skill covers but contains no "Use when..." clause or equivalent explicit trigger, so per the guideline a missing explicit-when caps completeness at 2 rather than 3.

2 / 3

Trigger Term Quality

"robots.txt", "sitemap", "meta tags", and "Core Web Vitals" are exactly the natural terms a user would say when they need this skill, giving good coverage rather than the partial coverage of score 2.

3 / 3

Distinctiveness Conflict Risk

The technical-SEO niche anchored by robots.txt, sitemap, and Core Web Vitals is a clear, specific domain unlikely to trigger for unrelated skills, matching the clear-niche anchor of 3.

3 / 3

Total

10

/

12

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (930 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

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