| name | seo-skill |
| description | >- Use when this capability is needed. |
SEO Skill — Static Site Optimization
Attribution: Vendored from aevans-eng/seo-skill (retrieved 2026-05-19). Minor edits: added frontmatter for Claude Code skill discoverability; replaced unicode check/cross with Y/N for ASCII compliance per CLAUDE.md §Ensure ASCII Code Symbols.
Lightweight audit and fix tool for static HTML sites (GitHub Pages, Netlify, Vercel, Astro static-output, etc.). No build tools required.
Setup
Before using, provide Claude with:
- Domain (e.g.
https://yourname.com)
- Pages list
- Social profiles
- Target keywords (what you want to rank for)
Claude retains this context for the session.
What to Check
1. Per-Page Head Essentials
Each HTML page requires:
<title> (50-60 chars): name + differentiator
<meta name="description"> (150-160 chars): unique, keyword-rich
<link rel="canonical">: matches deployed URL exactly
- Open Graph tags:
og:title, og:description, og:image (1200x630px)
- Twitter Card tags:
twitter:card, twitter:title, twitter:description, twitter:image
2. Structured Data (JSON-LD)
Homepage should include:
- Person / Organization schema: name, jobTitle, affiliation, sameAs links, knowsAbout
- WebSite schema: name, URL
Project / product pages use CreativeWork or SoftwareApplication schema with name, author, description, URL.
Rule: JSON-LD only. No FAQPage, HowTo, or placeholder text.
3. robots.txt
Create at site root:
User-agent: *
Allow: /
Sitemap: https://yourdomain.com/sitemap.xml
4. sitemap.xml
XML file listing all pages with <loc>, <lastmod> (YYYY-MM-DD), and <priority>.
5. Image SEO
- Descriptive
alt text on all <img> tags
- WebP format preferred; under 200KB
loading="lazy" for below-fold images
- OG image must be a real file
6. Content & Keywords
- One H1 per page including name/project name
- Proper heading hierarchy (h1 -> h2 -> h3)
- Your name appears naturally in body text
- Internal cross-linking between pages
- External links to social profiles
7. Technical Checks
- HTTPS throughout (all links and resources)
- Consistent trailing-slash convention
- No broken links
- Viewport meta tag on all pages
- Minimal/deferred JavaScript
8. Post-Deploy Verification
- Verify
/robots.txt and /sitemap.xml accessible
- Test OG tags via social preview (Discord/Slack)
- Submit sitemap in Google Search Console
- Monitor
site:yourdomain.com after a few days
- Track target keyword rankings
9. Google Search Console
- Add property for your domain
- Verify via DNS or HTML file
- Submit sitemap
- Monitor Coverage report
Audit Output Format
When invoked, read all HTML files and report:
| Check | Status | Notes |
|---|
| Meta descriptions | Y/N | Details |
| OG tags | Y/N | Details |
| JSON-LD schema | Y/N | Details |
| robots.txt | Y/N | Details |
| sitemap.xml | Y/N | Details |
| Image alt text | Y/N | Details |
| H1 tags | Y/N | Details |
| Internal links | Y/N | Details |
| Canonical URLs | Y/N | Details |
Then offer to fix what's missing.
Source: edobry/minsky — distributed by TomeVault.