CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fixing-metadata

Audit, fix, and validate HTML metadata. Use when shipping pages that need titles, descriptions, canonical URLs, Open Graph tags, Twitter cards, favicons, JSON-LD, or robots directives.

Quality

78%

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/frontend-ui/fixing-metadata/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 terse, well-sectioned contract with a sound fail-fast workflow, but it is almost entirely abstract: no commands, validators, code examples, or framework-specific metadata patterns anywhere in the body. The progressive-disclosure pointer targets a directory absent from the bundle, leaving the actual reference files orphaned.

Suggestions

Name the actual validators in the Validation section (e.g., a specific HTML metadata checker CLI or command) so "run the narrowest real validator" becomes executable guidance.

Add one concrete code example of the dominant framework metadata pattern (e.g., a Next.js metadata export or an OG/Twitter tag block) to anchor the abstract audit/fix steps.

Fix the Progressive Disclosure pointer: either reference the bundle's actual files (references/contract.yaml, evals.yaml, task-profile.json) by name or correct the non-existent Infrastructure/... archive path.

DimensionReasoningScore

Conciseness

The body is lean — short bullets, no explanations of concepts Claude already knows, no padding (e.g., "Inspect 2-3 focused surfaces before expanding scope"). It falls short of level 5 because Avoid, Gotchas, Anti-Patterns, and Validation overlap repetitively and could be tightened into fewer sections.

4 / 5

Actionability

The guidance is high-level hints with no concrete executable content: "Run the narrowest real validator or command path available" names no actual validator, "Inspect 2-3 focused surfaces" names no surface or command, and no code example (e.g., a Next.js metadata export or an OG-tag snippet) appears. This matches the level-2 anchor (high-level hints missing specific steps) and is below level 3 because there is not even partial concrete command or code guidance.

2 / 5

Workflow Clarity

The five-step workflow is clearly sequenced with explicit fail-fast and re-validation checkpoints ("Stop at the first failed gate or blocker", "Rerun the relevant validation after fixes before claiming completion"). It sits below level 5 because the checkpoints are abstract — no gate is defined by a concrete command or criterion — and above level 3 because validation is explicitly present in the sequence rather than implicit or missing.

4 / 5

Progressive Disclosure

Section organization within SKILL.md is clear, but scored against the actual bundle: the body points to "Infrastructure/references/deferred-skill-context/frontend-ui-fixing-metadata/", a directory that does not exist in this bundle, while the real reference files (references/contract.yaml, evals.yaml, task-profile.json) are never mentioned or navigable. References are neither clearly signaled nor resolvable, fitting the level-3 anchor (structure present but references not clearly signaled).

3 / 5

Total

13

/

20

Passed

Description

92%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 strong description: third-person voice, concrete verbs, an explicit 'Use when' clause, and a near-exhaustive enumeration of the metadata domain. The only soft spot is missing common synonyms such as "meta tags" or "SEO" that users might naturally say.

DimensionReasoningScore

Specificity

"Audit, fix, and validate HTML metadata" names three concrete actions and comprehensively enumerates the domain's artifact types ("titles, descriptions, canonical URLs, Open Graph tags, Twitter cards, favicons, JSON-LD, or robots directives"), matching the comprehensive-coverage anchor. It sits above the level-4 anchor because coverage of the metadata surface is exhaustive rather than leaving minor gaps.

5 / 5

Completeness

It explicitly answers what ("Audit, fix, and validate HTML metadata") and when ("Use when shipping pages that need...") with concrete trigger phrases, mirroring the level-5 example structure. Not level 4 because the 'when' clause is fully explicit and specific rather than merely adequate.

5 / 5

Trigger Term Quality

Terms like "canonical URLs", "Open Graph tags", "Twitter cards", "favicons", "JSON-LD", and "robots directives" are natural phrases users would say, but common variants like "meta tags" and "SEO" are absent. Good keyword coverage with a few natural terms missing fits the level-4 anchor; it is below level 5 because the synonym set is not comprehensive.

4 / 5

Distinctiveness Conflict Risk

"HTML metadata" with named triggers (Open Graph, favicons, JSON-LD, robots directives) carves a clear niche with minimal overlap risk against general frontend or document skills. It is a distinct-trigger skill rather than the mostly-distinct level-4 case.

5 / 5

Total

19

/

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

jscraik/Agent-Skills

Path

Skills/frontend-ui/fixing-metadata/SKILL.md

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.