CtrlK
BlogDocsLog inGet started
Tessl Logo

article

Use when auditing metadata, crawlability, structured data, or indexability related to Implement valid Article structured data. 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/article/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 lean, well-organized audit skill body with excellent progressive disclosure (a single, clearly signaled reference file that carries the code example and verification detail). The main weakness is actionability within the body itself — no named validation tool and no inline JSON-LD example — with a secondary gap in making the post-fix verification loop explicit.

Suggestions

In the 'Check' section, name a concrete validation tool (e.g., Google's Rich Results Test or Schema Markup Validator, or a curl command to inspect the rendered JSON-LD) so the verification step is executable rather than just directive.

Add a minimal JSON-LD skeleton inline in the 'Fix' section, or explicitly point to the 'Code Example' section of references/rule.md, so the fix step is copy-paste actionable.

Close the feedback loop: state that after applying the fix, the rendered HTML should be re-verified (per the Verification steps in references/rule.md) before treating the rule as satisfied.

DimensionReasoningScore

Conciseness

The body is lean and well-structured with short sections, but has minor trim candidates: the motivational opening sentence ('Structured data helps your content appear as rich results... significantly increasing click-through rates') explains context Claude largely already knows, and 'related to Implement valid Article structured data' repeats the title awkwardly. This matches anchor 4 (efficient with minor over-explanation) rather than anchor 5 (every token earns its place).

4 / 5

Actionability

The Quick Reference gives specific, concrete guidance ('Schema.org Article, NewsArticle, or BlogPosting types', 'headline, image, datePublished, and author', 'Format the data using JSON-LD'), but the body itself contains no code example or executable command: 'Check' names no validation tool, and 'Fix' only says to 'Add a JSON-LD script block containing the Article schema' without an inline example. This is some concrete guidance that is incomplete, matching anchor 3 rather than anchor 4 (concrete code or commands with minor gaps).

3 / 5

Workflow Clarity

The Check → Fix → Explain → Code Review structure forms a coherent audit workflow with 'Check' acting as an explicit verification step ('Verify that the page contains valid Article structured data with all required properties'), and the code-review section directs flagging exact routes/templates. However, post-fix re-verification is only implicit (the reference's Verification section is not surfaced as a workflow step), so it matches anchor 4 (clear sequence, most checkpoints, minor validation gaps) rather than anchor 5.

4 / 5

Progressive Disclosure

The body is a concise overview with clearly labeled sections and a single well-signaled, one-level-deep reference: 'For full implementation details, code examples, and framework-specific guidance, see references/rule.md' — a real bundle file that contains the JSON-LD code example and verification steps. Content is appropriately split and navigation is easy, matching anchor 5.

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, good natural keywords, and a concrete verification directive. Its weaknesses are a thin capability statement (what the skill actually does beyond verification) and trigger terms that overlap with sibling SEO audit skills.

DimensionReasoningScore

Specificity

The description names its domain and two concrete actions — 'auditing metadata, crawlability, structured data, or indexability' and 'Verify the rendered HTML and HTTP response rather than relying only on source files' — but stops short of listing several distinct capabilities. It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than anchor 4, which expects several specific actions.

3 / 5

Completeness

It explicitly answers 'when' via a concrete 'Use when auditing metadata, crawlability, structured data, or indexability' trigger clause, and states a 'what' (verify rendered HTML and HTTP response). The 'what' is thin — it omits the full capability set (checking validity, fixing, explaining Article schema) — so it does not reach anchor 5's 'clearly and explicitly answers both with concrete trigger phrases', but sits clearly above anchor 3 where 'when' is missing or only implied.

4 / 5

Trigger Term Quality

It includes good natural keywords a user would say — 'metadata', 'crawlability', 'structured data', 'indexability', 'rendered HTML', 'HTTP response' — giving solid coverage, but misses common synonyms such as 'JSON-LD', 'schema markup', 'rich snippets', or 'SEO'. This is good-but-not-comprehensive keyword coverage, matching anchor 4 rather than anchor 5.

4 / 5

Distinctiveness Conflict Risk

'Article structured data' is a clear niche with a mostly distinct trigger set, but the generic triggers 'metadata', 'crawlability', and 'indexability' overlap with closely related SEO audit skills in the same family (e.g., canonical URL, robots, meta description rules). Minor overlap risk with closely related skills matches anchor 4 rather than anchor 5's minimal conflict risk.

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.