CtrlK
BlogDocsLog inGet started
Tessl Logo

canonical-header

Use when auditing metadata, crawlability, structured data, or indexability related to Sync HTML canonical tags and Link headers. Verify the rendered HTML and HTTP response rather than relying only on source files.

60

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/canonical-header/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

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

A tight, well-structured overview for a simple SEO rule: clear check/fix/explain flow, no padding or concept re-teaching, and a properly signaled pointer to the real references/rule.md for details. The main gap is actionability — the body tells Claude what to compare but not how to inspect headers or rendered HTML with actual commands.

Suggestions

Add one or two inline executable commands to the Check section, e.g., 'curl -sI https://example.com | grep -i "^link"' and a note to inspect the rendered <head> (not the source template), so the core check is executable without opening the reference.

Include a brief match/no-match example inline (matching canonical URL vs. mismatched tag and header) so the failure condition is unambiguous at a glance.

DimensionReasoningScore

Conciseness

The ~30-line body is lean: a one-sentence rationale ("Conflicting canonical-url signals can lead search engines to ignore both declarations..."), short Quick Reference bullets, and terse Check/Fix/Explain/Code Review sections with no teaching of concepts Claude already knows. The three Quick Reference bullets ("Ensure the rel=canonical tag ... matches", "Avoid sending conflicting signals", "Maintain consistency across all methods") restate the same point three ways and could be trimmed, which is the minor over-explanation of anchor 4 rather than the tighter fit of 5.

4 / 5

Actionability

The Check section gives a concrete, unambiguous instruction ("Compare the HTML canonical tag with the HTTP Link header to ensure they point to the exact same URL") and Fix gives a remediation ("Update either the HTML tag or the HTTP header..."), but no executable commands or examples appear in the body — e.g., no 'curl -I <url>' to inspect the header or how to view rendered HTML — with code deferred to references/rule.md. That is some concrete guidance with missing key details, matching anchor 3 rather than 4's mostly-executable guidance.

3 / 5

Workflow Clarity

This is a simple, non-destructive single-task skill, and the section flow (Check → Fix → Explain → Code Review) lays out a coherent sequence with an unambiguous core action; the Code Review section even specifies flagging "exact routes or templates where search-facing output violates the rule" and how to "verify the final page output". It falls short of 5 only because no explicit verification checkpoint command is given in the body itself, leaving a minor validation gap typical of anchor 4.

4 / 5

Progressive Disclosure

The body is a concise overview with well-organized sections and a single, clearly signaled one-level-deep reference: "For full implementation details, code examples, and framework-specific guidance, see references/rule.md" — a real file that exists in the bundle. This matches the simple-skill guidance and anchor 5's clear overview with well-signaled shallow references; nothing that belongs in a separate file is inlined.

5 / 5

Total

16

/

20

Passed

Description

70%Weight 40%Scale 1-5

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

A solid description with an explicit 'Use when...' trigger, third-person voice, and natural SEO keywords. Its main weakness is a thin 'what': it says to verify rendered HTML and HTTP responses but never states the core check (HTML canonical tag and Link header must declare the same URL) or any fix action.

Suggestions

State the core action concretely, e.g., 'Compares the rel="canonical" HTML tag with the HTTP Link header and flags mismatched canonical URLs' — this would raise both specificity and completeness.

Add a remediation action such as 'update the tag or header so both declare the identical canonical URL' to round out capability coverage.

Include one or two common synonyms like 'SEO' or 'duplicate content' among the trigger terms to catch users who phrase the need differently.

DimensionReasoningScore

Specificity

The description names the domain ("Sync HTML canonical tags and Link headers") and two concrete actions ("auditing metadata, crawlability, structured data, or indexability" and "Verify the rendered HTML and HTTP response"), but does not state what is actually checked (tag/header URL consistency) or any remediation, so coverage is not comprehensive. It matches anchor 3 (domain plus 1-2 concrete actions) rather than anchor 4, which expects several specific actions; it is clearly above anchor 2, where actions are minimal or generic.

3 / 5

Completeness

Both parts are explicit: the trigger "Use when auditing metadata, crawlability, structured data, or indexability related to Sync HTML canonical tags and Link headers" and the what "Verify the rendered HTML and HTTP response rather than relying only on source files". The 'what' could be more specific about the actual check (comparing the canonical tag against the Link header for an exact URL match), so it sits at anchor 4 rather than 5; it is clearly above anchor 3, where 'when' is missing or only weakly implied.

4 / 5

Trigger Term Quality

It includes strong natural phrases users would say: "auditing metadata", "crawlability", "structured data", "indexability", "canonical tags", "Link headers", "rendered HTML", "HTTP response". A few common synonyms are missing (e.g., "SEO", "duplicate content", "canonical URL"), which keeps it at anchor 4 rather than 5's comprehensive synonym/extension coverage, while it is well above anchor 3's partial keyword set.

4 / 5

Distinctiveness Conflict Risk

The canonical tag/Link header pairing is a clear niche with distinct triggers, giving minimal conflict risk there. The broad leading terms "metadata, crawlability, structured data, or indexability" overlap with other SEO-audit skills, which is a minor overlap risk consistent with anchor 4 rather than 5.

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
thedaviddias/Front-End-Checklist
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.