seo-optimizer
This skill should be used when analyzing HTML/CSS websites for SEO optimization, fixing SEO issues, generating SEO reports, or implementing SEO best practices. Use when the user requests SEO audits, optimization, meta tag improvements, schema markup implementation, sitemap generation, or general search engine optimization tasks.
What this skill does
# SEO Optimizer
## Overview
This skill provides comprehensive SEO optimization capabilities for HTML/CSS websites. It analyzes websites for SEO issues, implements best practices, and generates optimization reports covering all critical SEO aspects including meta tags, heading structure, image optimization, schema markup, mobile optimization, and technical SEO.
## When to Use This Skill
Use this skill when the user requests:
- "Analyze my website for SEO issues"
- "Optimize this page for SEO"
- "Generate an SEO audit report"
- "Fix SEO problems on my website"
- "Add proper meta tags to my pages"
- "Implement schema markup"
- "Generate a sitemap"
- "Improve my site's search engine rankings"
- Any task related to search engine optimization for HTML/CSS websites
## Workflow
### 1. Initial SEO Analysis
Start with comprehensive analysis using the SEO analyzer script:
```bash
python scripts/seo_analyzer.py <directory_or_file>
```
This script analyzes HTML files and generates a detailed report covering:
- Title tags (length, presence, uniqueness)
- Meta descriptions (length, presence)
- Heading structure (H1-H6 hierarchy)
- Image alt attributes
- Open Graph tags
- Twitter Card tags
- Schema.org markup
- HTML lang attribute
- Viewport and charset meta tags
- Canonical URLs
- Content length
**Output Options**:
- Default: Human-readable text report with issues, warnings, and good practices
- `--json`: Machine-readable JSON format for programmatic processing
**Example Usage**:
```bash
# Analyze single file
python scripts/seo_analyzer.py index.html
# Analyze entire directory
python scripts/seo_analyzer.py ./public
# Get JSON output
python scripts/seo_analyzer.py ./public --json
```
### 2. Review Analysis Results
The analyzer categorizes findings into three levels:
**Critical Issues (🔴)** - Fix immediately:
- Missing title tags
- Missing meta descriptions
- Missing H1 headings
- Images without alt attributes
- Missing HTML lang attribute
**Warnings (⚠️)** - Fix soon for optimal SEO:
- Suboptimal title/description lengths
- Multiple H1 tags
- Missing Open Graph or Twitter Card tags
- Missing viewport meta tag
- Missing schema markup
- Heading hierarchy issues
**Good Practices (✅)** - Already optimized:
- Properly formatted elements
- Correct lengths
- Present required tags
### 3. Prioritize and Fix Issues
Address issues in priority order:
#### Priority 1: Critical Issues
**Missing or Poor Title Tags**:
```html
<!-- Add unique, descriptive title to <head> -->
<title>Primary Keyword - Secondary Keyword | Brand Name</title>
```
- Keep 50-60 characters
- Include target keywords at the beginning
- Make unique for each page
**Missing Meta Descriptions**:
```html
<!-- Add compelling description to <head> -->
<meta name="description" content="Clear, concise description that includes target keywords and encourages clicks. 150-160 characters.">
```
**Missing H1 or Multiple H1s**:
- Ensure exactly ONE H1 per page
- H1 should describe the main topic
- Should match or relate to title tag
**Images Without Alt Text**:
```html
<!-- Add descriptive alt text to all images -->
<img src="image.jpg" alt="Descriptive text explaining image content">
```
**Missing HTML Lang Attribute**:
```html
<!-- Add to opening <html> tag -->
<html lang="en">
```
#### Priority 2: Important Optimizations
**Viewport Meta Tag** (critical for mobile SEO):
```html
<meta name="viewport" content="width=device-width, initial-scale=1.0">
```
**Charset Declaration**:
```html
<meta charset="UTF-8">
```
**Open Graph Tags** (for social media sharing):
```html
<meta property="og:title" content="Your Page Title">
<meta property="og:description" content="Your page description">
<meta property="og:image" content="https://example.com/image.jpg">
<meta property="og:url" content="https://example.com/page-url">
<meta property="og:type" content="website">
```
**Twitter Card Tags**:
```html
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Your Page Title">
<meta name="twitter:description" content="Your page description">
<meta name="twitter:image" content="https://example.com/image.jpg">
```
**Canonical URL**:
```html
<link rel="canonical" href="https://example.com/preferred-url">
```
#### Priority 3: Advanced Optimization
**Schema Markup** - Refer to `references/schema_markup_guide.md` for detailed implementation. Common types:
- Organization (homepage)
- Article/BlogPosting (blog posts)
- LocalBusiness (local businesses)
- Breadcrumb (navigation)
- FAQ (FAQ pages)
- Product (e-commerce)
Example implementation:
```html
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Article Title",
"author": {
"@type": "Person",
"name": "Author Name"
},
"datePublished": "2024-01-15",
"image": "https://example.com/image.jpg"
}
</script>
```
### 4. Generate or Update Sitemap
After fixing issues, generate an XML sitemap:
```bash
python scripts/generate_sitemap.py <directory> <base_url> [output_file]
```
**Example**:
```bash
# Generate sitemap for website
python scripts/generate_sitemap.py ./public https://example.com
# Specify output location
python scripts/generate_sitemap.py ./public https://example.com ./public/sitemap.xml
```
The script:
- Automatically finds all HTML files
- Generates proper URLs
- Includes lastmod dates
- Estimates priority and changefreq values
- Creates properly formatted XML sitemap
**After generation**:
1. Upload sitemap.xml to website root
2. Add reference to robots.txt
3. Submit to Google Search Console and Bing Webmaster Tools
### 5. Update robots.txt
Use the template from `assets/robots.txt` and customize:
```
User-agent: *
Allow: /
# Block sensitive directories
Disallow: /admin/
Disallow: /private/
# Reference your sitemap
Sitemap: https://yourdomain.com/sitemap.xml
```
Place robots.txt in website root directory.
### 6. Verify and Test
After implementing fixes:
**Local Testing**:
1. Run the SEO analyzer again to verify fixes
2. Check that all critical issues are resolved
3. Ensure no new issues were introduced
**Online Testing**:
1. Deploy changes to production
2. Test with Google Rich Results Test: https://search.google.com/test/rich-results
3. Validate schema markup: https://validator.schema.org/
4. Check mobile-friendliness: https://search.google.com/test/mobile-friendly
5. Monitor in Google Search Console
### 7. Ongoing Optimization
**Regular maintenance**:
- Update sitemap when adding new pages
- Keep meta descriptions fresh and compelling
- Ensure new images have alt text
- Add schema markup to new content types
- Monitor Search Console for issues
- Update content regularly
## Common Optimization Patterns
### Pattern 1: New Website Setup
For a brand new HTML/CSS website:
1. Run initial analysis: `python scripts/seo_analyzer.py ./public`
2. Add essential meta tags to all pages (title, description, viewport)
3. Ensure proper heading structure (one H1 per page)
4. Add alt text to all images
5. Implement organization schema on homepage
6. Generate sitemap: `python scripts/generate_sitemap.py ./public https://yourdomain.com`
7. Create robots.txt from template
8. Deploy and submit sitemap to search engines
### Pattern 2: Existing Website Audit
For an existing website needing optimization:
1. Run comprehensive analysis: `python scripts/seo_analyzer.py ./public`
2. Identify and prioritize issues (critical first)
3. Fix critical issues across all pages
4. Add missing Open Graph and Twitter Card tags
5. Implement schema markup for appropriate pages
6. Regenerate sitemap with updates
7. Verify fixes with analyzer
8. Deploy and monitor
### Pattern 3: Single Page Optimization
For optimizing a specific page:
1. Analyze specific file: `python scripts/seo_analyzer.py page.html`
2. Fix identified issues
3. Optimize title and meta description for target keywords
4. Ensure proper heading hierarchy
5. Add appropriate schema markup for pagRelated in Ads & Marketing
ads
IncludedMulti-platform paid advertising audit and optimization skill. Analyzes Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple Ads. 250+ checks with scoring, parallel agents, industry templates, and AI creative generation.
banana
IncludedAI image generation Creative Director powered by Google Gemini Nano Banana models. Use this skill for ANY request involving image creation, editing, visual asset production, or creative direction. Triggers on: generate an image, create a photo, edit this picture, design a logo, make a banner, visual for my anything, and all /banana commands. Handles text-to-image, image editing, multi-turn creative sessions, batch workflows, and brand presets.
rpg-migration-analyzer
IncludedAnalyzes legacy RPG (Report Program Generator) programs from AS/400 and IBM i systems for migration to modern Java applications. Extracts business logic from RPG III/IV/ILE source code, identifies data structures (D-specs), file operations (F-specs), program dependencies (CALLB/CALLP), and converts RPG constructs to Java equivalents. Generates migration reports, complexity estimates, and Java implementation strategies with POJO classes, JPA entities, and service methods. Use when modernizing AS/400 or IBM i legacy systems, analyzing RPG source files (.rpg, .rpgle, .RPGLE), converting RPG to Java, mapping data specifications to Java classes, planning legacy system migration, or when user mentions RPG analysis, Report Program Generator, RPG III/IV/ILE, AS/400 modernization, IBM i migration, packed decimal conversion, or mainframe application rewrite.
brand-library-architect
IncludedBuild a complete brand library for a product — visual asset render pipeline, brand documentation set (BRAND, COPY, MANIFESTO, BIOS, FAQ, GLOSSARY, TONE, PRICING), open-source convention files (README, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT), and a self-contained press kit. This skill should be used when the user asks to "build a brand library / brand kit / press kit / brand assets" for a product, "set up a brand library workflow," "create a positioning manifesto plus visual identity," or any combination of brand documentation + visual asset pipeline. Apply phase-by-phase or run end-to-end. Templates are product-agnostic and use {{TOKEN}} placeholders the skill prompts the user to fill.
writing-tech-post
IncludedAuthors engineering blog posts end-to-end: launch deep-dives, incident postmortems, architecture migrations, performance case studies, tutorials, AI/agent system writeups, security disclosures, and research-to-product translations. Picks the correct archetype, plans the abstraction ladder, enforces an evidence cadence (diagrams, benchmarks, profiles, traces, code, ablations), tunes voice against publisher house styles (Datadog, Vercel, GitHub, AWS, Meta, Cloudflare, Jane Street), and runs a pre-publish gate for narrative momentum and disclosure ethics. Use when drafting a new engineering post, restructuring a draft that feels flat, deciding which evidence form belongs where, validating that depth and product context are balanced, or preparing a postmortem, migration, or performance narrative for external publication. Do not use for API reference documentation, README authoring, marketing copy, release notes, generic SEO content, ghost-written executive thought leadership, or non-engineering long-form essays.
blog-google
IncludedGoogle API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity analysis for E-E-A-T, YouTube video search for embedding, and Google Ads Keyword Planner. Progressive feature availability based on credential tier (API key, OAuth/service account, GA4, Ads). Shares config with claude-seo at ~/.config/claude-seo/google-api.json. Use when user says "google data", "page speed", "core web vitals", "search console", "indexation", "GA4", "keyword research", "nlp entities", "blog performance", "youtube search", "google api setup".