Blog Content Validation Skill for Codex

Production workflow for researching, writing, improving, scoring, and validating SEO-ready blog articles in Markdown, MDX, HTML, and static-site content systems.

This repository packages a reusable Codex skill for teams that publish researched content and need a repeatable QA process before a post goes live. It focuses on content production, SEO checks, source discipline, frontmatter quality, schema readiness, internal links, and rendered-page validation.

Many blog workflows fail at the handoff between writing and publishing. Drafts may look complete but still miss search intent, canonical metadata, author signals, source links, image alt text, FAQ coverage, sitemap inclusion, or basic Markdown constraints.

blog-publish-pipeline gives Codex a practical checklist and a local scoring script so every article can move through the same content QA gates.

• Create a researched SEO blog post from a keyword or topic
• Improve an existing Markdown or MDX article without changing its intent
• Validate title tags, meta descriptions, author metadata, and frontmatter
• Check internal links, external source links, FAQ coverage, image alt text, and paragraph length
• Prepare schema-ready articles for Article, BlogPosting, FAQPage, Person, and Organization
• Review blog content for E-E-A-T signals, source quality, and AI-search readability
• Run a pre-publish checklist before build, sitemap, and rendered-page verification

Codex skill, blog SEO, SEO content workflow, Markdown blog validation, MDX content QA, frontmatter validation, content marketing, schema markup, E-E-A-T, AI writing workflow, blog publishing checklist, technical SEO content audit.

• SKILL.md - Codex skill instructions and workflow
• scripts/score-markdown-blog.mjs - Local Markdown/MDX scoring script
• agents/openai.yaml - Agent metadata for OpenAI/Codex environments
• examples/seo-blog-post.sample.md - Minimal sample article for validation

Clone this repository into your Codex skills directory:

mkdir -p ~/.codex/skills
git clone https://github.com/BHINNKJ/blog-content-validation-skill.git ~/.codex/skills/blog-publish-pipeline

Or copy the folder into:

~/.codex/skills/blog-publish-pipeline

Then ask Codex to use blog-publish-pipeline when creating, improving, scoring, QA-checking, or preparing a blog post for publishing.

node ~/.codex/skills/blog-publish-pipeline/scripts/score-markdown-blog.mjs ./content/blog/example.md "primary keyword"

The script returns JSON with:

• overall score and status
• title and meta description length
• word count and heading structure
• paragraph length warnings
• internal and external link counts
• FAQ presence
• image and alt-text checks
• author, tag, date, and schema-readiness metadata
• exact-match keyword density
• issues, warnings, and suggestions

• 80+ score for publishable content
• 88+ score for strong content
• 45-65 character title where possible
• 120-155 character meta description
• paragraphs under 150 words
• at least 2 authoritative external sources for researched articles
• at least 3 relevant internal links when the site has matching pages
• author, author URL, publish date, and source-backed claims
• image alt text when images are used

This repo is intentionally named around the discoverable job it performs: blog content validation. The README uses plain-language search terms for developers, editors, marketers, and AI agent users looking for blog SEO workflows, Markdown QA, frontmatter validation, and Codex skill examples.

Recommended GitHub topics:

blog
seo
content-marketing
markdown
mdx
schema-org
eeat
content-validation
codex-skill
ai-writing

MIT