oyusypenko creo-seo — Next.js SEO + GEO specialist
Elite SEO specialist for Next.js applications. Covers technical SEO auditing, AI search optimization (LLMO/GEO), content E-E-A-T compliance, Core Web Vitals, schema deprecation awareness, citability scoring, and llms.txt generation.
Commands
| Command | What it does |
|---|---|
/creo seo onboard <url> |
Main lifecycle command — audit, implementation plan, guided GSC/Bing configuration, monitoring + autofix scaffold, standing cadence. See references/seo-onboarding.md. |
/creo seo plan <url> |
Analyze + produce a prioritized implementation plan (Problem/Fix/Verify, DEV/YOU tags, phased forecast) without the setup stages |
/creo seo init |
Scan codebase and write cached project profile to .claude/skills/creo-seo/creo-seo-{project_id}.md. Run this first. |
/creo seo audit <url> |
Main full-site audit — runs all 7 phases, produces markdown + JSON report |
/creo seo audit --brief <url> |
Fast audit: Technical + Build + Live + Scoring only |
/creo seo technical <url> |
Phase 1 + 3 + 4 — codebase/build/live tech checks |
/creo seo content <url> |
Phase 2 — content quality, E-E-A-T, AI-pattern detection |
/creo seo schema [<url>] |
Schema audit: generation, deprecation, validation |
/creo seo sitemap |
Sitemap audit + generation recommendations |
/creo seo citability <url> |
Passage-level AI citability score + rewrite priorities |
/creo seo llms-txt [--generate] |
Validate existing /llms.txt or generate new one |
/creo seo crawlers [--fix] |
Audit robots.txt for 14 AI crawlers; optionally rewrite |
/creo seo compare <old.md> <new.md> |
Delta between two prior audits |
/creo seo autofix [--dry-run] |
Closed-loop GSC remediation: detect, allowlisted fix, verify, notify, ledger (needs gsc-analyzer extension) |
/creo seo triage <bucket> |
Triage a GSC coverage bucket: expected vs concern, direction over level |
/creo seo semantic-core |
Build/refresh the focused query core with noise filtering and P0-P3 priorities |
/creo seo freshness |
Audit freshness signals: lastmod/dateModified divergence, year-staleness |
/creo seo offpage |
Off-page authority plan: directories, LLM citation slots, trust-killer sweep |
/creo seo weekly [--setup] |
Read the latest weekly snapshot, or scaffold the weekly monitoring workflow |
/creo seo page-rules |
Generate a project-scoped .claude/rules/seo-page-rule.md for page-creation-time enforcement |
Core instructions
Configuration
- Check for
.claude/project-config.md. Read:project_id,project_url,dev_server_url,locales,seosettings,reports_path. - Load project profile if it exists:
.claude/skills/creo-seo/creo-seo-{project_id}.md. This file caches page inventory, detected stack, and prior findings. Always prefer it over rescanning. - If project profile is missing, auto-run init logic (
/creo seo init) as Phase 1 of the audit. - If project profile is stale (>30 days OR
package.json/next.config.*modified since), flag as stale and refresh.
Expertise areas
- Next.js SEO — App Router + Pages Router, static + dynamic, SSR/SSG/ISR
- Internationalization — hreflang in sitemap,
alternates.languages, x-default - E-E-A-T — Experience/Expertise/Authoritativeness/Trustworthiness alignment
- AI Search (GEO) — Google AI Overviews, ChatGPT, Perplexity, Gemini, Copilot
- Core Web Vitals — LCP, INP, CLS (INP replaced FID March 2024)
- Structured Data — JSON-LD with deprecation awareness (HowTo, FAQPage, SpecialAnnouncement)
- Citability — passage-level AI-citation likelihood scoring
- AI Crawlers — 14-bot matrix, allow/block strategy
7-phase audit pipeline
- Codebase audit — page inventory, meta coverage, schema detection, i18n, images, links
- Content quality — humanity score, specificity, structure, SEO, readability (delegate to
creo-seo-contentagent if available) - Build audit —
npm run build, output validation, sitemap coverage - Live site audit — DOM meta check, CWV field data, rendering, security, redirects
- AI search readiness — citability scoring, AI crawler access, llms.txt, brand entity signals
- Schema deprecation & validation sweep — 10 validation rules
- Composite scoring + report — 8-dimension weighted score, letter grade, revenue impact
See the agent file for phase-by-phase details.
Default composite score weights
Technical SEO 22%
Content Quality 20%
On-Page SEO 15%
Schema 10%
Core Web Vitals 10%
AI Search 12%
Images 5%
Sitemap / robots 6%
Weights adjust per business type (SaaS, e-commerce, agency, local, creator, marketplace).
Schema templates by page type
| Page type | Primary | Complementary |
|---|---|---|
| Homepage | Organization + WebSite | sameAs, SearchAction |
| Product | Product | Offer, AggregateRating, Review |
| Pricing | SoftwareApplication / Offer catalog | — |
| Blog post | BlogPosting | Person, BreadcrumbList |
| Local | LocalBusiness (+subtype) | PostalAddress, GeoCoordinates |
| Event | Event | Offer, Place |
| Course | Course | CourseInstance |
| Job | JobPosting | — |
| Video | VideoObject | — |
Full catalog of 23 types: see references/schema-templates.md.
Meta tag requirements (every page)
<title>— unique, 30–60 chars<meta name="description">— unique, 140–160 chars<link rel="canonical">— absolute HTTPS URL- Open Graph: title, description, image, type, url
- Twitter Card: card, title, description, image
- For i18n sites:
alternates.languages+ x-default
AI crawler defaults
Allow by default (see references/ai-crawlers.md for full matrix):
- Tier 1: GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, PerplexityBot
- Tier 2: Google-Extended, GoogleOther, Applebot-Extended, Amazonbot, FacebookBot
Block: Bytespider (aggressive, low Western value).
Report output
Save to {reports_path}/seo-audit-{YYYYMMDD}-{HHMM}.md + sibling .json. See references/audit-report-template.md.
Default reports_path: .claude/reports/seo/.
Reference library
Loaded on demand based on command / phase:
| File | Purpose |
|---|---|
references/project-profile-template.md |
What /creo seo init writes |
references/audit-report-template.md |
What /creo seo audit writes |
references/scoring-rubric.md |
Composite score formulas + weights + business-type adjustments |
references/schema-templates.md |
23 JSON-LD templates + deprecation calendar + Next.js helpers |
references/schema-validation-checklist.md |
10 pre-publish schema rules |
references/sitemap-patterns.md |
Native + next-sitemap, dynamic, i18n, news/image/video, index splitting |
references/ai-crawlers.md |
14-bot matrix + robots.txt templates + Next.js app/robots.ts |
references/llms-txt-generator.md |
Spec, sections, validation, scoring, Next.js generator |
references/geo-citability.md |
5-dimension passage scoring + 134-167w window + multipliers |
references/content-quality-rubric.md |
5-dimension content score + page-type word-count gates |
references/ai-pattern-detection.md |
26 AI phrases, 24 vague words, specificity/conversational boosters |
references/internal-linking-recipe.md |
Link-per-page gates, anchor strategy, cluster model, Next.js patterns |
references/gsc-autofix-loop.md |
Closed-loop GSC remediation: fix allowlist, anti-thrash ledger, run sequence |
references/coverage-triage.md |
Reading GSC indexing buckets: expected vs concern, direction over level |
references/deploy-verification.md |
Edge-vs-origin checks, redirect assertions, canaries, validation windows |
references/semantic-core.md |
Focused query core: noise filtering, P0-P3, opportunity buckets, trend labels |
references/freshness-signals.md |
git-mtime as single source of truth, year policy, staleness CI guard |
references/page-seo-rules.md |
Page-creation-time SEO rules (metadata vs JSON-LD, route enums, checklists) |
references/seo-program-conventions.md |
DEV/YOU tags, Problem/Fix/Verify, changelogs, repeat-audit reports |
references/indexation-runbook.md |
Hypothesis-branch template for missing/unindexed route families |
references/offpage-authority.md |
Directory playbook, LLM citation slots, trust-killer sweep, Bing coverage |
references/seo-onboarding.md |
/creo seo onboard lifecycle: audit -> plan -> GSC setup -> monitoring cadence |
Quality gates
- Every finding includes exact file path + line number + concrete fix
- Issues prioritized by business impact
- Validation steps provided per fix
- All recommendations use project profile context
- Reports saved to disk, never console-only
- Every indexable page must have unique title + meta description
- JSON-LD must validate against
schema-validation-checklist.md - Sitemap must include every indexable page from inventory
Operations mode (Search Console lifecycle)
Beyond point-in-time audits, this skill runs an ongoing SEO operation when the
gsc-analyzer extension is installed (extensions/gsc-analyzer/ — scripts,
templates, GSC API reference, UI automation):
- Autofix (
/creo seo autofix) — the weekly closed loop perreferences/gsc-autofix-loop.md: detect via budgeted URL inspection, fix only allowlisted issue classes, verify live at origin AND edge (references/deploy-verification.md), notify Google, track everything in an anti-thrash ledger. Judgment-shaped issues become GitHub issues, never edits. - Triage (
/creo seo triage) — before fixing anything from a coverage report, applyreferences/coverage-triage.md: many buckets are expected canonicalization behavior, most 404/redirect rows self-heal, direction matters more than level. - Monitoring (
/creo seo weekly) — weekly rank-history snapshot on the focused core, optional Bing merge and LLM-citability tracking, year- staleness check, delivered as a PR (extensiontemplates/seo-weekly.yml). - Semantic core (
/creo seo semantic-core) — perreferences/semantic-core.md, with the per-project taxonomy inseo-site-config.json(extension template).
Without the extension, the operational commands still work in degraded mode: the skill reads exported CSVs, runs curl-based verification, and produces the same reports manually.
Companion skill
For deep content-only audits without running the full pipeline, route to creo-seo-content skill/agent (same repo). It reuses this skill's content-quality-rubric.md, ai-pattern-detection.md, and internal-linking-recipe.md refs.