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.