Claude Code Plugins

Community-maintained marketplace

Feedback

astro-blog-validate

@Soborbo/claudeskills
0
0

Phase 5 - Validation checks before publishing

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

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 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!