CtrlK
BlogDocsLog inGet started
Tessl Logo

blog-schema

Generate complete JSON-LD schema markup for blog posts with Article/BlogPosting, Person, Organization, BreadcrumbList, ImageObject, and optional FAQPage. Validates against Google requirements and warns about deprecated types. Use when user says "schema", "blog schema", "json-ld", "structured data", "schema markup", "generate schema".

72

Quality

88%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%

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

The body is highly actionable with complete templates and a strong validation workflow, but it is monolithic with no progressive disclosure via bundle files, and Google-doc caveats are repeated across steps. Tightening the redundant caveat passages and (optionally) extracting per-type templates into references would lift the lower dimensions.

Suggestions

Consolidate the repeated Google-doc/deprecated-type caveats (Step 2, Step 6, Step 8 generative-AI note) into a single validation section to improve conciseness.

Extract per-type schema templates and the per-surface status table into a references/ file (e.g. schema-templates.md) and link to it from SKILL.md to add one-level-deep progressive disclosure.

Tighten Step 6 (FAQPage) by removing explanatory context Claude already knows, keeping only the emit-condition rules.

DimensionReasoningScore

Conciseness

Mostly efficient with concrete JSON templates and minimal conceptual preamble, but Google-doc caveats are restated across Step 2, Step 6 (FAQPage), and the Step 8 generative-AI note, which could be consolidated; it is tighter than the verbose anchor but not fully lean.

2 / 3

Actionability

Provides complete, copy-paste-ready JSON-LD templates for every schema type, a per-surface validation table, eight explicit validation checks, and a concrete script-safe encoding procedure (replace '</' with '<\/', '<' with '\u003c').

3 / 3

Workflow Clarity

A clear 9-step sequence (Read -> generate each entity -> Validate & Warn -> Output) with an explicit validation checklist and feedback guidance, satisfying the anchor for clear sequencing with validation checkpoints.

3 / 3

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so the ~290-line body is a single monolithic file with all templates and the validation table inline; it is well-sectioned but lacks one-level-deep external references that the per-type reference material could be split into.

2 / 3

Total

10

/

12

Passed

Description

100%

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 is strong: it states concrete capabilities, enumerates the schema types handled, includes validation/warning behavior, and gives an explicit natural-language trigger list. It uses third-person imperative voice throughout with no first/second-person phrasing.

DimensionReasoningScore

Specificity

Lists multiple concrete actions ('Generate complete JSON-LD schema markup', 'Validates against Google requirements', 'warns about deprecated types') and enumerates specific schema types (Article/BlogPosting, Person, Organization, BreadcrumbList, ImageObject, FAQPage), matching the 'lists multiple specific concrete actions' anchor.

3 / 3

Completeness

Clearly answers both 'what' (generate, validate, warn) and 'when' with an explicit 'Use when user says...' clause, matching the anchor requiring explicit triggers for both.

3 / 3

Trigger Term Quality

Provides an explicit natural-language trigger list ('schema', 'blog schema', 'json-ld', 'structured data', 'schema markup', 'generate schema') that users would naturally say, giving good coverage of common variations.

3 / 3

Distinctiveness Conflict Risk

Targets a clear niche (blog JSON-LD structured data) with distinct triggers unlikely to fire for unrelated skills, matching the 'clear niche with distinct triggers' anchor.

3 / 3

Total

12

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
AgriciDaniel/claude-blog
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.