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".
Security Assessment
About blog-schema
Blog Schema is a structured-data generation skill in the claude-blog toolkit. It solves the problem of adding correct, validated JSON-LD schema markup to blog posts so that search engines and other consumers can better understand the content. Using the @graph pattern, it combines multiple schema types (BlogPosting/Article, Person, Organization, BreadcrumbList, ImageObject, optional FAQPage, and VideoObject) into a single script tag with stable @id references for entity linking.
The workflow reads a blog post, extracts schema-relevant data (title, author, dates, description, FAQ pairs, images, organization info, word count, tags, slug), and then generates each schema entity step by step with documented templates. It reflects current search-engine guidance rather than stale rules: it notes that Google's Article docs do not define hard required properties and recommends validating with the Rich Results Test, warns that Google retired FAQ rich results in 2026 so FAQPage should only be emitted when a visible FAQ genuinely helps readers, and cautions against substituting QAPage for editorial FAQs. A final validation step checks per-surface support before recommending schema types.
The skill is a single self-contained SKILL.md with no scripts or executables. Target users are bloggers, SEO practitioners, and web developers who want standards-compliant structured data without hand-writing JSON-LD. Use cases include enriching an existing post with author and organization entities, adding breadcrumb navigation markup, and generating VideoObject entries for embedded YouTube videos.
FAQ
What schema types can it generate?
BlogPosting/Article, Person, Organization, BreadcrumbList, ImageObject, optional FAQPage, and VideoObject, all combined into a single @graph with stable @id references.
Does it still recommend FAQPage markup?
Only conditionally. It notes Google retired FAQ rich results for all sites in 2026, so FAQPage earns no rich-result credit and should be emitted only when a visible, genuinely helpful FAQ exists.
How should the generated schema be validated?
The skill directs you to validate against Google's Rich Results Test and to treat missing recommended fields as warnings unless the target surface requires them.
Does the skill run any code or need dependencies?
No. It is a single documentation file (SKILL.md) that guides Claude to read a post and emit JSON-LD. There are no scripts, executables, or external dependencies.
Install blog-schema
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
agricidaniel/claude-blog