CtrlK
BlogDocsLog inGet started
Tessl Logo

meta-description

Use when auditing page metadata or generating descriptions for new pages. Applies to every page that should receive organic search traffic.

56

Quality

65%

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/meta-description/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 well-structured, appropriately brief skill body with excellent progressive disclosure to a single real reference file. Its main defects are an internal contradiction on the length criterion (120–160 vs. 70–160 characters) that muddies both actionability and the validation checkpoint, and a near-verbatim duplicated sentence between the intro and Explain sections.

Suggestions

Reconcile the length ranges: Quick Reference, Check, and Fix say 120–160 characters while Code Review says 70–160 — pick one standard (or explain the 70–160 audit tolerance vs. 120–160 writing target) so the validation criterion is unambiguous.

Remove the duplication between the intro and the Explain section — the identical "organic ad copy / not a ranking signal" sentence appears twice; keep it once.

Inline one short good/bad example pair in the Fix section (or state character-count checking explicitly) so the writing guidance is executable without opening the reference file.

DimensionReasoningScore

Conciseness

The body is mostly efficient — short sections, no explanations of concepts Claude already knows — but "A compelling meta description acts as organic ad copy in search results—well-written descriptions improve click-through rates even though they are not a direct ranking signal" appears near-verbatim in both the intro and the Explain section, and the not-a-ranking-factor point is made three times across Quick Reference, Explain, and the intro. This duplication fits the level-3 anchor of mostly efficient but could be tightened; it is not 2 because nothing is padded background explanation.

3 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: "Add or update the <meta name='description' content='...'> tag in <head>. Write a unique summary of 120–160 characters", plus enumerated Code Review criteria (exists, non-empty, length range, no HTML tags, unique). It falls short of 5 because the length criterion is internally contradictory — Quick Reference and Check say 120–160 while Code Review says "between 70 and 160 characters" — and no example description is shown inline. It stays above 3 because the directives need no inference to execute.

4 / 5

Workflow Clarity

The Check → Fix → Explain → Code Review structure gives a clear single-pass sequence with a validation checkpoint ("Flag pages where it is missing, duplicated, or outside the recommended length"), earning level 4. It is not 5 because the contradictory length ranges (120–160 vs. 70–160) leave the checkpoint criterion ambiguous — a reviewer cannot tell which threshold to enforce. This is an audit/fix skill, not a destructive or batch operation, so the destructive-cap rule does not apply.

4 / 5

Progressive Disclosure

The 45-line body is well-sectioned with a clear overview, and the single bundle file (references/rule.md) is referenced exactly once, clearly signaled, and one level deep — "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — and that file exists with matching content. This matches the level-5 anchor of a clear overview with well-signaled one-level-deep references; the reference file itself does not chain further.

5 / 5

Total

16

/

20

Passed

Description

58%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.

The description has an explicit, well-formed trigger clause and avoids fluff, but it undersells the skill's actual specificity: the term "meta description" — the single phrase a user would most naturally say — never appears, replaced by the broader "page metadata". This weakens trigger-term quality and creates overlap risk with adjacent metadata/SEO skills.

Suggestions

Name the concrete artifact explicitly, e.g. "Audits and writes HTML meta description tags (uniqueness, 120–160 character length) for pages targeting organic search."

Add the natural trigger terms users would say — "meta description", "SEO metadata", "search snippet" — to improve keyword coverage.

Clarify scope so it reads as meta-description-specific rather than all page metadata, reducing conflict with title-tag or Open Graph skills.

DimensionReasoningScore

Specificity

The description names the domain and exactly two concrete actions ("auditing page metadata" and "generating descriptions for new pages"), matching the level-3 anchor of 1-2 concrete actions without comprehensive coverage. It does not reach 4 because "page metadata" is broader than the skill's actual scope (meta descriptions only) and no further specific actions (writing, validating length/uniqueness) are listed.

3 / 5

Completeness

Both parts are present: an explicit "Use when auditing page metadata or generating descriptions for new pages" trigger clause plus a stated action, matching the level-4 anchor where both exist but one could be more specific. It is not 5 because the "what" never explicitly names "meta description" — the reader must infer the concrete artifact — and it is not 3 because the "when" is explicit and the "what" is stated rather than missing.

4 / 5

Trigger Term Quality

Relevant keywords exist ("page metadata", "descriptions", "organic search traffic", "new pages") but the natural phrases a user would actually say — "meta description", "SEO", "search snippet", "SERP" — are absent, which is precisely the level-3 anchor of having some relevant keywords while missing common variations and synonyms. It is above level 2 because multiple genuinely relevant keywords are present, not just one or two generic ones.

3 / 5

Distinctiveness Conflict Risk

"Auditing page metadata" and "generating descriptions" could plausibly overlap with adjacent SEO/metadata skills (title tags, Open Graph tags, general copywriting), fitting the level-3 anchor of somewhat specific with residual overlap risk. The "organic search traffic" scope narrows it somewhat, but not enough for level 4's "mostly distinct" since the skill's own name (meta-description) is more distinctive than anything in the description text.

3 / 5

Total

13

/

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.