blog-post-validator

Validate blog post drafts for frontmatter, structure, en-GB spelling, and ScottInk style.

59|10|Updated Jul 17, 2021
One-click install
npx skills add https://github.com/spences10/scottspence.com --skill blog-post-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blog-post-validator
Source: https://github.com/spences10/scottspence.com/tree/main/.claude/skills/blog-post-validator
Command: npx skills add https://github.com/spences10/scottspence.com --skill blog-post-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Ensuring blog posts meet all quality, style, and linguistic standards before publication is a critical but often manual and error-prone task. This Skill automates the comprehensive validation process, guaranteeing consistent, high-quality content every time.

Core Features & Use Cases

  • Comprehensive Quality Checks: Validates frontmatter, structural flow (Hook → Problem → Solution), voice (first-person, British English), and code examples.
  • Linguistic & Style Enforcement: Strictly checks for en-GB spelling, correct grammar, and adherence to the "ScottInk" style guide, flagging corporate speak or vague conclusions.
  • Code Integrity: Ensures all code blocks have language identifiers and that examples are working and relevant to the narrative.
  • Use Case: Before publishing a new technical blog post, use this Skill to perform a final review. It will automatically check for correct frontmatter, consistent British English spelling, proper code block formatting, and adherence to the "ScottInk" voice, ensuring your post is polished and professional.

Quick Start

Use the blog-post-validator skill to review the attached blog post 'my-draft-post.md' for publication readiness.

Frequently Asked Questions about blog-post-validator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate blog posts for en-GB spelling and style consistency before publishing?

Blog post validation checks frontmatter, structure, en-GB spelling, and voice adherence automatically. Run the validator on your draft markdown to catch spelling errors, confirm British English usage, verify proper heading hierarchy, and ensure first-person tone before publication.

What does a blog post structure check include?

Structure validation enforces the Hook → Problem → Investigation → Solution → Results flow. It verifies frontmatter completeness (title, date, published), H2-only headings, code blocks with language identifiers, and working examples relevant to your narrative.

Can I use this validator for technical blog posts with code examples?

Yes. The validator specifically checks that all code blocks include language identifiers and contain working, relevant examples. It flags missing syntax declarations and ensures code supports your blog's technical narrative.

Does the validator enforce a specific style guide?

The validator enforces the ScottInk style guide, flagging corporate speak, vague conclusions, and non-first-person voice. It ensures consistency with your publication's editorial standards and linguistic tone.

What frontmatter requirements does the validator check?

Frontmatter validation requires title, date, and published fields. The validator confirms these fields are present and properly formatted before marking your post ready for publication.