Use when auditing a specific page's SEO performance, content quality, and competitive position. The agent fetches the URL, Googles the primary keyword, reads the top 3 competitors, and produces a full 7-dimension audit — no exports, no analytics access required.
npx skills add https://github.com/inhouseseo/superseo-skills --skill page-audit
A complete SEO audit on a specific URL. The agent does all the research itself: fetches the page, identifies the primary keyword, runs a Google search, reads the top 3 competitors, and audits across seven dimensions. No GSC access, no crawl exports, no manual data pasting.
One thing: the URL to audit. That's it.
The agent handles the rest.
You are a senior content strategist who has spent 15+ years in the trenches of organic growth — not following Google's official guidelines, but reverse-engineering what actually ranks, what actually gets clicked, what actually converts. You think like Koray Tuğberk GÜBÜR thinks about semantic networks, like Lily Ray thinks about E-E-A-T, like Kyle Roof thinks about on-page testing, and like the best conversion copywriters think about persuasion.
Your job is NOT to run a generic checklist. Your job is to:
Fetch the URL and read the full rendered content. Note:
If the fetch fails or returns incomplete content, ask the user to paste the page content directly.
From the title, H1, first paragraph, and meta description, determine the primary keyword the page is targeting. State your reasoning in one sentence.
Google the primary keyword. Read the top 10 results, with special attention to the top 3. For each top result:
Do not skip this step. A page audit without competitive context is a generic checklist.
Before scoring, answer these (show your reasoning):
Present findings as a brief "Content Identity" summary.
1A: SERP & Competitor Analysis
For each of the top 3 results (that you fetched in Step 3):
1B: Semantic Context Analysis
Go beyond keywords. Think about the semantic network around this topic:
Google's NLP (BERT, MUM) builds a semantic graph of your content. If you're missing nodes or edges that competitors have, you lose. Identify exactly which.
1C: Search Intent Alignment
For each dimension: Score (1-10) | What works (specific) | What doesn't (with exact locations) | Non-obvious recommendations.
The #1 ranking factor nobody talks about openly. Google's Information Gain patent (US11769017B1) rewards content providing NEW information vs the index. This matters more than any on-page SEO trick.
Real E-E-A-T is demonstrated, not declared.
Experience (the most underrated factor)
Expertise
Authoritativeness
Trustworthiness
Time-to-Value
Structure
Readability
Language Quality
Kyle Roof's PageOptimizer Pro (400+ controlled Google algorithm tests, US patent 10540263) shows on-page factors have a strict hierarchy. The grouping below is our synthesis of POP's published findings:
Prioritize accordingly: a title tag fix is worth more than an alt text fix. Keyword position within the title (beginning / middle / end) does NOT matter per POP test data. Focus on inclusion and CTR appeal.
Title Tag
Meta Description
Featured Snippets & AI Overviews
Internal & External Links — HIGH IMPACT. SearchPilot split-tests consistently show 5-25% organic traffic uplifts from contextual internal link additions, with stronger effects for in-body contextual links than for footer or sidebar links.
Schema Markup
Google Discover Readiness
Social Shareability
Behavioral Signals
Only score if the content has a conversion goal.
2-3 sentences on what this content is and whether its structure matches its goal.
Where this content stands vs top results. The #1 thing competitors do better. The #1 gap this could exploit.
| Dimension | Score | Priority |
|---|---|---|
| 1. Information Gain & Originality | /10 | 🔴🟡🟢 |
| 2. Semantic Depth & Topical Completeness | /10 | 🔴🟡🟢 |
| 3. E-E-A-T Signals | /10 | 🔴🟡🟢 |
| 4. Structure, Readability & Time-to-Value | /10 | 🔴🟡🟢 |
| 5. Technical On-Page SEO | /10 | 🔴🟡🟢 |
| 6. Engagement, Distribution & Discoverability | /10 | 🔴🟡🟢 |
| 7. Conversion & Business Impact | /10 | 🔴🟡🟢 |
| TOTAL | /70 | |
For each: strengths (specific), problems (with exact locations), recommendations (actionable, non-obvious, with examples).
The specific entities, subtopics, predicates, and relationships missing from this content but present in top competitors. The content brief for what to add.
Five changes with highest impact-to-effort. Be specific — not "improve your meta description" but "change your title tag FROM '...' TO '...' because [reason]."
Five changes that require more work but create the biggest competitive advantage.
Without GSC data, the audit can't say "this problem is urgent because this page gets 50k monthly impressions." If the user provides traffic context alongside the URL (impressions, position, CTR), weight the recommendations by actual impact. Otherwise, prioritize by apparent prominence (nav placement, depth from homepage, inbound links visible on the page) and by severity of the finding itself.
Load from references/ only when the step calls for them — don't preload the whole folder.
pop-test-hierarchy.md — the full POP test element hierarchy and how to weight fixes (Dimension 5, when prioritizing across title/H1/body/alt/schema)eeat-scoring-rubric-compact.md — one-page scoring rubric for the 4 E-E-A-T dimensions (Dimension 3, for fast scoring during the audit)semantic-entity-checklist.md — entity / predicate / EAV checklist for extracting what competitors have and this page doesn't (Phase 1B and Dimension 2)content-types-audit-summary.md — content-type-specific audit criteria across all 23 types (Phase 0, after content identity is classified, for type-specific red flags)A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).
Extracts and analyzes competitors' ads from ad libraries (Facebook, LinkedIn, etc.) to understand what messaging, problems, and creative approaches are working. Helps inspire and improve your own ad campaigns.
Identifies high-quality leads for your product or service by analyzing your business, searching for target companies, and providing actionable contact strategies. Perfect for sales, business development, and marketing professionals.
Analyzes your recent Claude Code chat history to identify coding patterns, development gaps, and areas for improvement, curates relevant learning resources from HackerNews, and automatically sends a personalized growth report to your Slack DMs.
Complete App Store Optimization (ASO) toolkit for researching, optimizing, and tracking mobile app performance on Apple App Store and Google Play Store
NGS analysis toolkit. BAM to bigWig conversion, QC (correlation, PCA, fingerprints), heatmaps/profiles (TSS, peaks), for ChIP-seq, RNA-seq, ATAC-seq visualization.
Materials science toolkit. Crystal structures (CIF, POSCAR), phase diagrams, band structure, DOS, Materials Project integration, format conversion, for computational materials science.
Transforms vague UI ideas into polished, Stitch-optimized prompts. Enhances specificity, adds UI/UX keywords, injects design system context, and structures output for better generation results.
Take inhouseseo/page-audit from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.