seo-geo-on-top/SKILL.md
Battle-tested SEO+GEO playbook to rank on page 1 and get cited by AI answer engines. Use when writing or optimizing posts, adding JSON-LD schema, fixing technical SEO, or diagnosing rankings.
npx skillsauth add clownnvd/claude-code-skills seo-geo-on-topInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Get content to page 1 of Google AND get quoted by AI answer engines (Google AI Overviews, ChatGPT, Perplexity, Gemini, Bing Copilot). Evidence over theory — this skill leads with what actually ranked SpeakShark, and stays true via a living field log you update after every real result.
references/field-log.md
outranks any "best practice". Treat unlogged theory (including other geo-* skills
and this skill's own theory sections) as a hypothesis to test, not a law.curl/GSC, not
a summarizer — small models miss <script ld+json> and report false negatives
(this happened during the SpeakShark audit: schema was reported "missing" when 8
JSON-LD blocks were live).references/keyword-research.md.references/content-onpage.md +
references/geo-ai-engines.md, then the checklist below.references/schema-cookbook.md (paste-ready JSON-LD).references/technical-seo.md.references/local-international.md.references/geo-ai-engines.md.references/entity-sameas.md.references/offpage-authority.md.references/distribution-multichannel.md.references/updates-penalties-recovery.md.references/cro-analytics.md.references/measurement-iteration.md.references/field-log.md.references/proven-stack.md.Covers every aspect: keyword research · on-page · technical · international/local · schema/structured data · GEO/AI-engine citation · entity/sameAs · off-page/links/PR · multichannel distribution + SERP features · algorithm updates/penalties/recovery · AI-content safety · CRO · analytics/measurement.
Ranked #2 on Google + quoted verbatim by Google AI Overview for the high-intent query "best english speaking apps 2026". By confidence:
| Lever | Why it worked | Conf. | |-------|---------------|-------| | Freshness + year in title | "best X 2026" triggers query-deserves-freshness; publish + index inside the window | HIGH | | Exact-intent listicle + comparison table | matches commercial-investigation intent; tables are AI-extractable | HIGH | | Credible E-E-A-T framing | "tested across…", honest "no app wins all", THEN product = "Editor's Pick" | HIGH | | Complete server-rendered JSON-LD | Article + FAQPage + Speakable → AI-engine extraction/citation | MED | | Topical cluster + 15+ internal links | sibling posts on intent variants build topic authority | MED | | Immediate indexing (GSC + IndexNow/Bing) | catches the freshness window | MED |
ls/grep
src/features/blog/content). If one already exists, DO NOT write a new post —
OPTIMIZE the existing one or skip. A duplicate cannibalizes both URLs.
→ keyword-research.md<N> Best <thing> in <YEAR> (<scope>). Year mandatory.Organization.sameAs with real profiles; build off-page
mentions. → entity-sameas.mdContent/GEO — [ ] intent matches SERP format · [ ] year in title · [ ] answer- first intro · [ ] comparison table up top · [ ] one H2 per pick · [ ] honest trade-offs + Editor's Pick · [ ] 5–6 FAQ (body + frontmatter) · [ ] self-contained quotable chunks · [ ] specific numbers/entities · [ ] 15+ internal links · [ ] cluster intent differentiated (no cannibalization).
Technical — [ ] renders in raw HTML (curl) incl. JSON-LD · [ ] self-canonical absolute · [ ] sitemap + accurate lastmod · [ ] hreflang reciprocal + x-default · [ ] not noindex · [ ] AI crawlers allowed (curl -A GPTBot) · [ ] CWV ok · [ ] GSC index request + IndexNow ping.
Schema/Entity — [ ] Article + FAQPage + Breadcrumb + Speakable, server-rendered
· [ ] Organization + WebSite + SoftwareApplication site-wide · [ ] sameAs
populated with resolving URLs · [ ] Person author for E-E-A-T · [ ] validated
(Rich Results + curl | grep ld+json).
Organization.sameAs is empty → the #1 untapped entity signal. Populate with
real LinkedIn/X/YouTube/Crunchbase/Wikidata/App Store URLs. → entity-sameas.mdAfter ANY real ranking result tied to this playbook — a post hits/loses a position,
an AI engine cites/drops the brand, a schema/sameAs change correlates with movement
— append a dated entry to references/field-log.md using the template in
references/measurement-iteration.md. Promote a hypothesis into "Proven levers"
only after a logged win; demote/delete any lever the log later contradicts. The
playbook MUST always reflect the log, not the other way around.
tools
Zustand v5 state management for Next.js 16. Store patterns, middleware (persist/immer/devtools), SSR hydration, CV editor multi-step wizard, 20 documented errors. Triggers: zustand, store, state management, useState replacement, global state, persist, immer.
development
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.
development
Ultimate UI/UX design intelligence with real app flow knowledge. 93 styles, 121 palettes, 81 font pairings, 35 charts, 79 components, 62 animations, 65 WCAG criteria, 46 responsive patterns, 46 dark mode rules, 60 design tokens, 13 stacks. PLUS: Claude.ai full UI blueprint (19 flows, all screens), PageFlows app patterns. Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check, clone, recreate, rebuild. Styles: glassmorphism, brutalism, neumorphism, bento, dark mode, view transitions, scroll-driven, container queries, AI-native, liquid glass, neo-minimalism, mesh gradient, geometric abstraction. Topics: color, accessibility, animation, layout, typography, spacing, shadow, gradient, responsive, dark mode, WCAG 2.2, design tokens, components, spring physics, kinetic typography, container queries, popover API, semantic tokens. Apps: claude.ai, ChatGPT-style, AI chat UI, SaaS dashboard.
development
--- name: ui description: UI quality system. 4 modes: research (design brief), score (10-category audit), fix (auto-fix from scorecard), pipeline (end-to-end chain). license: Complete terms in LICENSE.txt --- # UI Quality System One skill, 4 modes. Research real products, score UI quality, fix issues, or run the full pipeline. ## Modes | Mode | Use When | Workflow | |------|----------|---------| | **research** | Before building any page | Extract tokens → Search → Fetch → Design Brief | | **