astro-blog-validate

📁 soborbo/claudeskills 📅 4 days ago
2
总安装量
2
周安装量
#64574
全站排名
安装命令
npx skills add https://github.com/soborbo/claudeskills --skill astro-blog-validate

Agent 安装分布

opencode 2
gemini-cli 2
antigravity 2
github-copilot 2
codex 2
kimi-cli 2

Skill 文档

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 imageloading="eager" + fetchpriority="high"
  • Other imagesloading="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!