Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Marketing & sales

optimise-seo

Implements Next.js crawlability, metadata, canonicals, status codes, JSON-LD, hreflang, and crawler policy with served-page evidence. Use when asked to "fix SEO", "add a sitemap", "fix soft 404s", or "add llms.txt". For demand research, briefs, or Search Console monitoring use seo-program.

mblode · AI review on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add mblode/agent-skills --skill optimise-seo

About this skill


name: optimise-seo description: Implements Next.js crawlability, metadata, canonicals, status codes, JSON-LD, hreflang, and crawler policy with served-page evidence. Use when asked to "fix SEO", "add a sitemap", "fix soft 404s", or "add llms.txt". For demand research, briefs, or Search Console monitoring use seo-program.

Optimise SEO

  • IS: crawlability, metadata, structured data, canonicals, redirects, status codes, hreflang, AI-crawler policy and extractable page structure, Core Web Vitals, programmatic SEO, security and privacy headers, and error-page behaviour, implemented in a Next.js App Router codebase.
  • IS NOT: visual redesign, layout, or page-level UI quality (ui-design Direction, Build, and Audit modes), demand research, briefs, question maps, or Search Console monitoring (seo-program), tenant routing for robots.txt and sitemap.xml (multi-tenant-architecture), or writing the article (external ghostwriter).

Allowed surface: metadata and generateMetadata, JSON-LD, semantic HTML, internal links, alt text, app/sitemap.ts, app/robots.ts, app/feed.xml/route.ts, app/llms.txt/route.ts, proxy.ts, next.config.ts redirects and headers, error pages, and performance work. Component styling and layout stay as they are; when a fix needs a layout change, name it as a handoff to ui-design.

Before writing code, read the matching guide in node_modules/next/dist/docs/ (resolved from the app directory; in a monorepo the next package is not visible from the repo root). The bundled docs match the installed version; the notes in references/nextjs-implementation.md were checked against 16.3 and say where behaviour changed.

References

FileRead when
references/indexing-policy.mdRedirects, duplicate URLs, index decisions, or pages generated at scale
references/nextjs-implementation.mdBefore writing code in steps 2-4: metadata, sitemap and robots, redirects, indexing, streaming 404s, JSON-LD, OG images, CSP
references/answer-engines.mdThe task touches AI crawlers, robots.ts rules for GPTBot or ClaudeBot, llms.txt, Content-Signal, or "why are we not cited"
references/internationalisation.mdThe site has more than one locale
references/technical-hardening.mdHeaders, cookies, consent, GPC, security.txt, or maintenance and error-status tasks
references/validation-evidence.mdStep 5: served-page commands and evidence expectations
references/seo-checklist.mdStep 5: copy into the report and mark each line with evidence

Workflow

Copy and track this checklist:

SEO progress:
- [ ] Step 1: Inventory routes and decide index intent per route
- [ ] Step 2: Fix crawl/index foundations (sitemap, robots, canonicals, redirects, status codes)
- [ ] Step 3: Implement metadata and structured data
- [ ] Step 4: Improve semantics, extractable answers, internal links, and Core Web Vitals
- [ ] Step 5: Validate with references/seo-checklist.md and report evidence

Step 1 is a table: route, index or noindex, canonical, reason. Every later step reads from it, and a route with no row gets no work.

Must-have on every site

  • app/sitemap.ts lists every indexable URL with lastModified derived from content; app/robots.ts names it
  • One canonical per page, one host, one casing, one trailing-slash policy, set through alternates.canonical with metadataBase in the root layout. Next.js enforces the slash policy itself: by default it 308s /about/ to /about, and trailingSlash: true inverts that (files with extensions and .well-known/ paths are exempt either way)
  • Preserve the property's existing ownership verification. Use metadata.verification only for a supplied token and the chosen verification method; DNS verification needs no duplicate meta tag
  • Root layout robots lifts Google's default preview caps: googleBot: { 'max-snippet': -1, 'max-image-preview': 'large', 'max-video-preview': -1 }. Without them Google truncates the snippet and the image preview, and the snippet cap is what AI surfaces read against when deciding how much of a page they may quote
  • authors and creator set explicitly in the root layout, so person-level attribution does not live only in footer HTML and JSON-LD
  • Unique title and description per page; title and H1 lead with the non-brand primary keyword and agree in intent (a brand-led title on a category page competes only for navigational queries the site already wins)
  • Every page opens with a short, plain-text answer to the question it exists to answer; the h2s are the questions people actually ask
  • Open Graph and Twitter Card tags with a 1200x630 image
  • JSON-LD: Organization and WebSite once in a root @graph with stable @ids, BreadcrumbList on inner pages, then Article, Product, ProfilePage, or LocalBusiness where the content type matches. Define an entity once and reference it by @id
  • One h1, logical h2-h6, descriptive alt text, internal links between related pages
  • Core Web Vitals in target at the p75 of CrUX field data: LCP 2.5 s, INP 200 ms, CLS 0.1 (INP replaced FID in March 2024; a guide still naming FID is stale)

Redirects and indexing policy

Load references/indexing-policy.md when routes move, duplicates need consolidation, or page indexing policy changes. Verify behavior against the installed Next.js version and served responses.

AI crawlers and answer engines

Google needs no special files: AI Overviews and AI Mode run on Googlebot and core ranking, and nosnippet or max-snippet:0 is the only opt-out (it removes the normal snippet too). Everything else is a robots decision per crawler class: search and citation bots (OAI-SearchBot, Claude-SearchBot, `Perpl

Read the complete source ↗