# SEO Audit > Audit a webpage's SEO and generate a scored report with actionable fixes. USE WHEN: - User provides a URL and asks to check/audit/review its SEO - User asks "how's my site's SEO?" or "what SEO issues does [URL] have?" - User wants to improve search rankings for a specific page - User asks to review meta tags, headings, or on-page optimization DON'T USE WHEN: - User wants keyword research or content strategy (that's research, not an audit) - User wants to track rankings over time (use a rank tracking tool) - User wants technical site-wide crawl analysis (this audits single pages, not full sites) - User wants Google Search Console or Analytics data (requires API access, not page scraping) - User wants to fix SEO issues (this diagnoses — fixing is a separate step) - User wants backlink analysis (requires third-party tools like Ahrefs/Moz) OUTPUTS: Markdown report with overall score (0-100), category breakdowns (Meta, Content, Technical, Performance), critical issues, warnings, and prioritized recommendations. IN - Skill: `johnalbertini14-glitch/seo-audit-2` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/seo-audit-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/seo-audit-2/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Marketing & Growth - Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch) - Updated: 2026-09-21 - Page: https://skillmd.com/skills/johnalbertini14-glitch/seo-audit-2 --- # SEO Audit Analyze any webpage for SEO issues and generate an actionable report. ## Workflow 1. Fetch the target URL using `web_fetch` 2. Analyze the HTML content for SEO factors (see checklist below) 3. Score each category (0-100) 4. Generate a formatted report with findings and recommendations 5. Save report as markdown file ## SEO Checklist ### Meta & Head (25 points) - Title tag exists, 30-60 chars, contains target keywords - Meta description exists, 120-160 chars, compelling - Canonical URL present - Open Graph tags (og:title, og:description, og:image) - Twitter Card tags - Favicon reference - Language attribute on `` ### Content Quality (25 points) - Single H1 tag present - Logical heading hierarchy (H1 → H2 → H3) - Word count (minimum 300 for ranking) - Image alt text coverage - Internal links present - External links present - No broken heading structure ### Technical (25 points) - Mobile viewport meta tag - HTTPS (check URL scheme) - Clean URL structure (no excessive params) - Structured data / Schema.org markup - No duplicate content signals - robots meta tag check ### Performance Indicators (25 points) - Total HTML size (flag if >100KB) - Image count and alt coverage - External resource count (CSS/JS files) - Inline CSS volume (flag if excessive) - Render-blocking resources estimate ## Report Format ```markdown # SEO Audit Report: [URL] **Date:** [date] **Overall Score:** [X/100] ## Summary [2-3 sentence overview] ## Scores | Category | Score | Status | |----------|-------|--------| | Meta & Head | X/25 | ✅/⚠️/❌ | | Content | X/25 | ✅/⚠️/❌ | | Technical | X/25 | ✅/⚠️/❌ | | Performance | X/25 | ✅/⚠️/❌ | ## Findings ### Critical Issues ... ### Warnings ... ### Passed ... ## Recommendations [Prioritized action items] ``` ## Scoring - ✅ 80%+ of category points = Good - ⚠️ 50-79% = Needs improvement - ❌ Below 50% = Critical issues ## Common Mistakes to Avoid - **Don't audit without fetching** — always fetch the actual page HTML, don't guess from the URL alone - **Don't penalize single-page apps unfairly** — SPAs often have minimal HTML; note it but don't tank the score - **Don't report Open Graph as "critical"** — it's important but not a ranking factor. Keep severity accurate. - **Don't ignore context** — a personal blog doesn't need Schema.org markup the way an e-commerce site does. Tailor severity to the site type.