CtrlK
BlogDocsLog inGet started
Tessl Logo

json-ld-valid

Use when generating or auditing any `<script type='application/ld+json'>` blocks, implementing structured data for articles, products, FAQs, breadcrumbs, or local businesses, or investigating why rich results are not appearing in Google Search Console.

63

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/json-ld-valid/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, actionable body with concrete per-type property requirements and a clean pointer to a real one-level-deep reference file. The main weakness is redundancy — the Check, Fix, and Code Review sections repeat the same procedure, and the Explain section restates concepts Claude already knows.

Suggestions

Merge the 'Check' and 'Code Review' sections — they both describe the identical parse → verify @context/@type → check required properties workflow, so one combined section would remove roughly a third of the body.

Trim the 'Explain' section: descriptions of what rich results are (stars, images, expandable Q&As) are concepts Claude already knows; keep only the non-obvious point that Google silently drops invalid blocks with no error surfaced.

Make the validation feedback loop explicit: after fixing issues, state 're-run the Rich Results Test and iterate until no errors remain' rather than listing validation only as a final step.

DimensionReasoningScore

Conciseness

Individual sentences are lean, but the 'Check', 'Fix', and 'Code Review' sections restate the same parse → verify @context/@type → check required properties procedure nearly verbatim, and the 'Explain' section describes concepts Claude already knows ("enhanced search result formats that include stars, images, expandable Q&s"). Fits anchor 3 (mostly efficient, could be tightened) better than 2 because the fix is merging redundant sections, not cutting padded prose.

3 / 5

Actionability

Concrete, executable guidance throughout: exact numbered steps, per-type required properties ("Article: headline, author… datePublished"), JSON.parse() for syntax checking, and specific validation URLs (search.google.com/test/rich-results, jsonlint.com). As an instruction-only skill the absence of inline code is not penalized; 'Run through Google's Rich Results Test API if available' is the one under-specified step, keeping it below anchor 5.

4 / 5

Workflow Clarity

Both 'Check' (steps 1–5) and 'Fix' (steps 1–6) present clear numbered sequences with validation checkpoints (Rich Results Test before deploying). The fix→re-validate feedback loop is implied rather than explicitly stated as a retry cycle, which matches anchor 4 rather than 5. This is a read/validate task, not a destructive or batch operation, so the cap-at-3 rule does not apply.

4 / 5

Progressive Disclosure

The body is short (~40 lines) and well-sectioned, and closes with a clearly signaled, one-level-deep reference — "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — and the referenced file exists in the bundle (references/rule.md, 159 lines with valid/invalid JSON-LD examples). Matches the clear-overview-with-well-signaled-references anchor.

5 / 5

Total

16

/

20

Passed

Description

78%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 with an explicit Use-when clause, concrete actions, and distinctive technical triggers covering the main use cases (generation, auditing, and rich-result debugging). Its only weaknesses are the 'what' being embedded in the when-clause and a couple of missing natural synonyms like 'schema markup'.

DimensionReasoningScore

Specificity

Names the JSON-LD domain and several concrete actions ("generating or auditing any `<script type='application/ld+json'>` blocks", "implementing structured data for articles, products, FAQs, breadcrumbs, or local businesses", "investigating why rich results are not appearing") across five content types. Scored 4 rather than 5 because coverage has minor gaps — e.g., validating/fixing existing blocks is implied by 'auditing' but not explicitly listed.

4 / 5

Completeness

An explicit "Use when…" clause is present with concrete trigger phrases, so completeness is not capped at 3. The 'what' (generate/audit/implement JSON-LD structured data) is stated but woven into the when-clause rather than clearly standalone, so it falls short of anchor 5's 'clearly and explicitly answers both what AND when'.

4 / 5

Trigger Term Quality

Good coverage of natural terms users would say: "structured data", "rich results", "Google Search Console", "JSON-LD", and the literal script tag. A few common synonyms are missing — notably "schema markup" and "schema.org", which users frequently say when they need this skill.

4 / 5

Distinctiveness Conflict Risk

Clear niche (JSON-LD structured data for SEO) with highly distinct triggers — the literal `<script type='application/ld+json'>` tag, 'rich results', and 'Google Search Console' — making conflict with other skills minimal.

5 / 5

Total

17

/

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.