astro-blog-validate

Phase 5 - Validation checks before publishing

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "astro-blog-validate" with this command: npx skills add soborbo/claudeskills/soborbo-claudeskills-astro-blog-validate

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 intent field
  • 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 add rel="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 any types in components
  • NO client:load - All interactive components use client:visible or client: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:

  1. All ⭐ checks passed - List any failures that need fixing
  2. Readability scores - Hemingway, Flesch scores meet targets
  3. Performance scores - Lighthouse mobile ≥90, desktop ≥95
  4. Article ready to publish - Yes/No

Final Step

Article complete and validated. Ready to publish!

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

astro-seo

No summary provided by upstream source.

Repository SourceNeeds Review
General

astro-ux

No summary provided by upstream source.

Repository SourceNeeds Review
General

astro-a11y

No summary provided by upstream source.

Repository SourceNeeds Review
General

astro-animations

No summary provided by upstream source.

Repository SourceNeeds Review