seo-content-optimizer
$
npx mdskill add OneWave-AI/claude-skills/seo-content-optimizerComprehensive SEO analysis and optimization for content creators and marketers.
SKILL.md
.github/skills/seo-content-optimizerView on GitHub ↗
--- name: seo-content-optimizer description: Optimize content for search engines with keyword analysis, readability scoring, meta descriptions, and competitor comparison. Use this when users want to improve SEO, optimize blog posts, or analyze content for search performance. --- # SEO Content Optimizer Comprehensive SEO analysis and optimization for content creators and marketers. To optimize content for SEO, provide a detailed analysis covering keywords, readability, technical SEO, and actionable recommendations. ## Instructions ### 1. Analyze Target Keywords Examine keyword usage and placement: - Identify primary keyword(s) from user input or content - Check keyword placement (title, H1, first 100 words, subheadings) - Calculate keyword density (aim for 1-2%) - Identify LSI keywords and semantic variations present - Flag keyword stuffing issues ### 2. Evaluate Content Structure Assess the organization and hierarchy: - Check heading hierarchy (single H1, then multiple H2, then H3) - Verify keyword usage in headings - Evaluate heading descriptiveness - Check paragraph length (aim for <150 words) - Assess overall scanability ### 3. Readability Analysis Calculate readability metrics: - Flesch Reading Ease score (aim for 60-70) - Grade level estimation - Average sentence length (aim for <20 words) - Passive voice percentage (minimize) - Transition word usage - Paragraph structure ### 4. Technical SEO Elements Generate optimized meta elements: - **Meta Title**: 50-60 characters with primary keyword - **Meta Description**: 150-160 characters, compelling with keyword - **URL Slug**: Short, keyword-rich, hyphen-separated - **Image Alt Text**: Descriptive with keywords where natural - **Internal Linking**: Opportunities to link to related content - **External Links**: Quality of outbound links ### 5. Content Quality Assessment Evaluate comprehensiveness: - Word count (competitive topics need 1500+ words) - Content depth and detail level - Topic coverage completeness - Unique value proposition - E-A-T signals (expertise, authority, trust) - Content freshness (dates, current examples) ### 6. Provide Actionable Recommendations Prioritize improvements by impact: **Critical (Fix Immediately)**: - Missing or poor meta description - No keyword in title or H1 - Broken internal links - Keyword density too high/low **High Priority**: - Poor readability score - Weak heading structure - Missing alt text on images - Content too thin **Medium Priority**: - Could add related keywords - Opportunity for featured snippet - Could improve internal linking Provide specific, actionable fixes with examples. ## Output Format ```markdown # SEO Analysis Report ## Overall Score: X/100 ### Target Keywords - Primary: [keyword] (density: X.X%) - Secondary: [keyword 1], [keyword 2] - LSI Keywords Found: [variations] ## Quick Wins (Implement First) 1. [Specific action with exact change needed] 2. [Specific action with exact change needed] ## Keyword Analysis [Pass] Keyword in title [Fail] Keyword missing in first 100 words - add to opening paragraph [Pass] Keyword in 2/5 H2 headings [Warn] Density: 0.8% (low - aim for 1-2%) ## Readability Metrics - **Flesch Reading Ease**: XX/100 (Grade level: XX) - **Average Sentence Length**: XX words - **Passive Voice**: X% - **Transition Words**: X% - **Assessment**: [Good/Needs improvement] ## Meta Information **Current Meta Title** (X chars): [current title] **Suggested Meta Title** (XX chars): `[Optimized title with keyword - 50-60 chars]` **Current Meta Description**: [current or none] **Suggested Meta Description** (XXX chars): `[Compelling 150-160 char description with keyword and CTA]` **URL Slug**: Current: `/current-url-slug` Suggested: `/keyword-rich-slug` ## Content Structure - **Word Count**: XXXX words ([sufficient/too short] for this topic) - **Heading Hierarchy**: [assessment] - **Paragraph Length**: Average XX words [good/too long] - **Sections**: [list main sections] ## Critical Issues ### 1. [Issue Name] **Problem**: [Description] **Impact**: [SEO impact] **Fix**: [Specific instruction] **Example**: ``` Current: [show current problematic text] Improved: [show corrected version] ``` ## High Priority Recommendations ### 1. [Recommendation] [Specific actionable instruction] ## Content Gaps Missing subtopics to add: - **[Subtopic 1]**: [Why it's important] (search volume: XXX) - **[Subtopic 2]**: [Why it's important] ## Internal Linking Opportunities - Link to: [page URL] using anchor text: "[keyword phrase]" - Link from: [this content] to [related page] ## Featured Snippet Opportunity [If applicable, show how to format content for featured snippet] Example: ```markdown ## What is [topic]? [Clear, concise 40-60 word answer] - Key point 1 - Key point 2 - Key point 3 ``` ## Competitor Insights [If analysis was done] - Top ranking content averages XXXX words - Common topics covered: [list] - Content advantage: [unique angle] ## Implementation Checklist - [ ] Update meta title and description - [ ] Add keyword to first paragraph - [ ] Fix heading structure - [ ] Add missing alt text (X images) - [ ] Add internal links (X opportunities) - [ ] Expand [thin section] with XXX words - [ ] Add FAQ section for featured snippet ## Estimated Impact **Time to Implement**: X hours **Expected Improvement**: [Moderate/Significant] ranking boost **Priority**: [High/Medium/Low] ``` ## Best Practices - **Prioritize user experience** over keyword stuffing - **Write for humans first**, optimize for search engines second - **Provide specific examples**, not vague advice - **Consider search intent** behind keywords (informational, commercial, transactional) - **Recommend content additions**, not just optimization - **Check for E-A-T signals** (author bio, credentials, sources) - **Suggest schema markup** where relevant (FAQ, How-To, Review) - **Look for featured snippet opportunities** (definition boxes, lists, tables) ## Example Workflow **User request**: "Optimize this blog post for 'best project management tools'" **Analysis**: 1. Check keyword placement - found in title but not H1 (fix needed) 2. Calculate density - 0.5% (too low, needs 8-10 more mentions) 3. Analyze readability - Flesch score 55 (good), but sentences too long 4. Generate meta tags - create compelling meta description 5. Identify gaps - missing "pricing comparison" and "team size recommendations" 6. Find internal links - link to "project management tips" article 7. Suggest featured snippet - format comparison table 8. Provide prioritized action list --- **Remember**: SEO is about creating valuable, well-optimized content that serves user intent better than competitors.
More from OneWave-AI/claude-skills
- accessibility-auditorAudit websites for accessibility issues and WCAG compliance. Use when checking accessibility, fixing a11y issues, or ensuring WCAG compliance.
- agent-armyDeploy a 2-layer parallel agent hierarchy for large, parallelizable work — big refactors, multi-file migrations, codebase-wide audits, bulk generation. Layer 1 is 3-50+ specialist agents, each with its own full context window; Layer 2 is 2+ sub-agents per member. Includes git safety, tiered sizing, a pre-deploy gate, phantom-completion checks, and multi-wave follow-up.
- agent-swarm-deployerDeploys swarms of sub-agents for massive parallel data processing tasks. Unlike agent-army (which is for code changes), this is for DATA tasks -- processing 1000 documents, analyzing datasets, bulk content generation. Configurable swarm size, task distribution, result aggregation, progress tracking, and error recovery.
- agent-team-builderDesigns and deploys custom agent teams for specific business workflows. Interactive discovery of business processes, then generates complete team configurations with specialized agent roles, tool access, communication protocols, and handoff rules.
- agent-to-agentAgent-to-Agent (A2A) communication protocol. Connect two or more Claude agents that pass messages, share context, delegate tasks, and collaborate. Implements structured handoffs, shared memory, and multi-agent conversations.
- ai-readiness-assessmentAssesses how ready a business is for AI adoption across six dimensions. Evaluates data maturity, tech stack, team skills, process documentation, budget, and culture. Generates a comprehensive ai-readiness-report.md with scores, gap analysis, and recommended starting points. Aligned with OneWave AI's audit methodology.
- animateGenerate animated videos and motion graphics from natural language descriptions. Creates a standalone Vite + React project with Framer Motion scenes that auto-play in the browser. Use when the user wants to create animations, motion graphics, video intros, animated presentations, or product demos.
- api-documentation-writerGenerate comprehensive API documentation including endpoint descriptions, request/response examples, authentication guides, error codes, and SDKs. Creates OpenAPI/Swagger specs, REST API docs, and developer-friendly reference materials. Use when users need to document APIs, create technical references, or write developer documentation.
- api-endpoint-scaffolderGenerate REST API endpoints with proper structure, validation, error handling, and types. Use when creating new API routes, endpoints, or backend services.
- api-load-testerLoad tests API endpoints with progressive concurrency. Measures response times, error rates, throughput, and identifies breaking points. Generates a detailed report with latency percentiles, throughput curves, bottleneck analysis, and optimization recommendations.