| name | astro-blog-validate |
| description | Phase 5 - Validation checks before publishing |
Astro Blog - Phase 5: Validation
Priority Legend:
- ⭐ ALWAYS - Every article, non-negotiable
- 🎯 HIGH-VALUE - Competitive keywords, commercial/pillar content
Validation Checklist
⭐ Critical Checks (Must Pass - Every Article)
- Human voice test - Read first 3 paragraphs aloud. Would someone guess AI wrote this? If yes, rewrite with more variety and imperfection
- Component density - Count all components (QueryAnswer, TL;DR, ExpertInsight, EngagementHook, etc). Max 5-7 (standard), 8-12 (pillar)
- Intentional typos - Count typing errors. Need 2-4 per article (thier, recieve, definately). NOT grammar errors
- AI pattern detection - Check for: All answer-first paragraphs? Transition words (Moreover, Furthermore)? Meta-commentary (It's important to note)? If yes, fix
⭐ Readability Scores (Every Article)
Use hemingwayapp.com or readabilityformulas.com:
- Hemingway Grade: 6-8 (max 10 acceptable)
- Flesch Reading Ease: 60-70 (Plain English)
- Flesch-Kincaid Grade: 8-10 (max 12 for technical)
- Sentence length: <20% of sentences exceed 25 words
- Passive voice: <10% of sentences
⭐ Content Quality (Every Article)
- Intent declared - Frontmatter has
intentfield - CTA matches intent - Check mapping table (informational→Newsletter, commercial→Quote, etc)
- Answer in first 120 words - QueryAnswer contains specific, direct answer with numbers
- TL;DR present - If >1000 words, TL;DR with exactly 3 bullet points
- TOC present - If >800 words, table of contents after intro
- H2 density - 3-4 H2 sections (standard) or 5-8 H2 sections (pillar)
- ExpertInsight count - 1-2 (standard) or 2-3 (pillar). NOT one per H2 (too formulaic)
⭐ Structure (Every Article)
- Internal links: 2-4 (standard) or 8-12 (pillar)
- First link position - Within first 100 words
- Anchor text quality - Descriptive phrases, no "click here" or "this article"
- Images: 3-5 (standard) or 6-10 (pillar)
- Image filenames - Descriptive with keywords (solar-panels-uk-2026.webp)
- Image captions - Present on screenshots, case studies, charts
- Visual spacing - No text blocks >350 words without image/list/table
- Paragraph length - Max 100 words, prefer 50-80 words
⭐ External Links (Every Article)
- Minimum 4 links - 1 citation + 1 authority + 1 reputation + 1 contextual
- Authority quality - At least 2 links to: gov.uk, .ac.uk, Which?, trade bodies, or professional LinkedIn profiles
- Context sentences - Every external link has explanatory sentence (no "source" or "here" anchors)
- Rel attributes - All external links have
rel="noopener noreferrer". Affiliate links addrel="nofollow sponsored"
⭐ Technical Validation (Every Article)
- Required frontmatter - All fields present: title, description, pubDate, intent, topic, primaryCTA, category, author, entities
- Meta description: 150-160 chars - Use formula: [Answer] + [Benefit] + [Proof] + [CTA]
- FAQ schema - Required for commercial/comparison intent. 3-5 questions (standard), 5-8 (pillar)
- HowTo schema - Required for process/guide articles. 3-10 steps
- TypeScript strict - No
anytypes in components - NO
client:load- All interactive components useclient:visibleorclient:idle
⭐ Performance (Every Article)
Run Lighthouse audit:
- PageSpeed Mobile ≥90
- PageSpeed Desktop ≥95
- Bundle sizes - <100KB JavaScript, <50KB CSS
- Hero image -
loading="eager"+fetchpriority="high" - Other images -
loading="lazy"
⭐ E-E-A-T (Every Article)
- ExperienceBlock data - Real case studies OR marked as placeholder. NO fabricated data
- Author credentials - Verifiable via LinkedIn profile link
- All statistics sourced - No "Studies show..." without citation and link
🎯 Information Gain (High-Value Articles)
- At least ONE of: (1) Original data/survey, (2) Unique case study, (3) Contrarian insight backed by evidence, (4) New framework/methodology, (5) Expert quote from interview
Output Required
Confirm:
- All ⭐ checks passed - List any failures that need fixing
- Readability scores - Hemingway, Flesch scores meet targets
- Performance scores - Lighthouse mobile ≥90, desktop ≥95
- Article ready to publish - Yes/No
Final Step
Article complete and validated. Ready to publish!