astro-blog-structure
Astro Blog - Phase 2: Structure
Priority Legend:
- ⭐ ALWAYS - Every article, non-negotiable
- 🎯 HIGH-VALUE - Competitive keywords, commercial/pillar content
⚠️ CRITICAL: Read astro-blog/references/human-voice.md NOW before planning structure to avoid AI-like patterns
Content Structure Planning
⭐ Core Structure (Every Article)
- H2 section density - 3-4 sections (standard 1000-1500w) OR 5-8 sections (pillar 3000-5000w)
- H2s are questions - Prefer specific questions users actually ask. Example: "How much does solar panel installation cost in the UK?" NOT "Pricing Overview"
- H3 subheadings - Use only for H2 sections >400 words. Max 3-4 H3s per H2. Keeps content scannable
- TOC required - If article >800 words, add table of contents after intro
- Component density limits - Max 5-7 components (standard) or 8-12 (pillar). Components = QueryAnswer, TL;DR, ExpertInsight, EngagementHook, etc.
- Visual breaks - No more than 3 paragraphs (150-300 words) without image/list/table/component
More from soborbo/claudeskills
astro-seo
SEO markup patterns for Astro lead generation sites. Meta tags, Open Graph, Schema.org, sitemap, robots. Use for all SEO implementation.
37astro-architecture
Technical architecture for Astro lead generation websites. Use when setting up new projects, configuring build tools, or establishing project foundations. For images use astro-images skill. For SEO use astro-seo skill.
20astro-performance
Core Web Vitals and performance optimization for Astro sites. LCP preloading, font strategy, image patterns, critical path, third-party scripts, Cloudflare Tag Gateway. Use for performance tuning.
18astro-animations
Animation patterns for Astro sites. Scroll animations, micro-interactions, transitions, loading states. Performance-focused, accessibility-aware.
17astro-a11y
Accessibility patterns for Astro lead generation sites. WCAG 2.1 AA compliance, screen readers, keyboard navigation, focus management, ARIA. Use for all accessibility implementation.
14astro-images
Width-based responsive image patterns for Astro. Local processing, AVIF/WebP/JPG, face-focus, OG generation. Includes Picture and FixedImage components.
14