Skill

seo-technical

JSON-LD structured data, sitemap.xml, robots.txt, Open Graph tags, canonical URLs, and Firebase Hosting SEO headers

Install

Run in your terminal

npx claudepluginhub javimontano/jm-adk-alfa

Tool Access

This skill uses the workspace's default tool permissions.

Supporting Assets

View in Repository

agents/guardian.md

agents/lead.md

agents/specialist.md

agents/support.md

evals/evals.json

knowledge/body-of-knowledge.md

knowledge/knowledge-graph.md

prompts/meta.md

prompts/primary.md

prompts/variations/deep.md

prompts/variations/quick.md

templates/output.docx.md

templates/output.html

Skill Content

Similar Skills

skill-lookup

Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.

prompts.chat

157.5k

prompt-lookup

Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.

prompts.chat

157.5k

agent-eval

Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.

everything-claude-code

139.2k

Stats

Stars1

Forks0

Last CommitMar 28, 2026

Actions

View Source View Plugin View on GitHub View README

097 — Technical SEO {Performance}

Purpose

Ensure search engines can discover, crawl, and index all public pages correctly. Implement structured data for rich snippets, sitemaps for crawl efficiency, and Open Graph tags for social sharing. [EXPLICIT]

Physics — 3 Immutable Laws

Law of Crawlability: If a search engine cannot reach and render a page, it does not exist. SPA rendering, robots.txt, and canonical URLs must work together. [EXPLICIT]
Law of Structured Communication: Machines understand structured data. JSON-LD tells Google what content means — not just what it says. [EXPLICIT]
Law of Single Source: Every page has exactly one canonical URL. Duplicate content is consolidated. Redirect chains are eliminated. [EXPLICIT]

Protocol

Phase 1 — Crawl Foundation

Generate sitemap.xml from route definitions. Include lastmod, changefreq, priority. [EXPLICIT]
Create robots.txt: allow all public paths, disallow /admin/, /api/. [EXPLICIT]
Configure Firebase Hosting headers: X-Robots-Tag: index, follow for public pages. [EXPLICIT]
For SPAs: implement prerendering (react-snap) or SSR for SEO-critical pages. [EXPLICIT]

Phase 2 — Structured Data

Add JSON-LD <script type="application/ld+json"> to page <head>. [EXPLICIT]
Implement schema types: Organization, WebSite, BreadcrumbList, Article, Product as applicable. [EXPLICIT]
Validate with Google Rich Results Test for every schema type. [EXPLICIT]
Dynamic pages: generate JSON-LD from Firestore data at render time. [EXPLICIT]

Phase 3 — Meta Tags & Social

<title> unique per page, < 60 characters, keyword-front-loaded. [EXPLICIT]
<meta name="description"> unique per page, < 160 characters, action-oriented. [EXPLICIT]
<link rel="canonical"> on every page — self-referencing or pointing to primary URL. [EXPLICIT]
Open Graph: og:title, og:description, og:image (1200x630px), og:url. [EXPLICIT]
Twitter Card: twitter:card=summary_large_image, twitter:title, twitter:image. [EXPLICIT]

I/O

Input	Output
Route definitions	`sitemap.xml` with all public URLs
Content/page data	JSON-LD structured data per page
Page metadata	`<title>`, `<meta>`, OG tags per page
Firebase Hosting config	SEO-optimized headers

Quality Gates — 5 Checks

sitemap.xml accessible at /sitemap.xml — lists all public URLs. [EXPLICIT]
robots.txt valid — Google Search Console shows no crawl errors. [EXPLICIT]
JSON-LD validates — zero errors in Google Rich Results Test. [EXPLICIT]
Canonical URLs on all pages — no duplicate content issues. [EXPLICIT]
OG image renders correctly — test with Facebook Sharing Debugger. [EXPLICIT]

Edge Cases

SPA rendering: Google renders JS but prerendering is more reliable. Use react-snap or dynamic rendering.
Paginated content: Use rel="next" / rel="prev" or load-more pattern with canonical to first page.
Multilingual: hreflang tags for each language variant. Separate sitemaps per language.
Dynamic OG images: Generate per-page OG images via Cloud Function if content varies.

Self-Correction Triggers

Pages missing from Google index → check sitemap, robots.txt, canonical tags.
Rich results disappearing → revalidate JSON-LD, check for schema errors.
Social shares show wrong image → verify OG tags, clear Facebook/Twitter cache.
Crawl budget wasted → audit robots.txt, block non-essential paths from crawling.

Usage

Example invocations:

"/seo-technical" — Run the full seo technical workflow
"seo technical on this project" — Apply to current context

Assumptions & Limits

Assumes access to project artifacts (code, docs, configs) [EXPLICIT]
Requires English-language output unless otherwise specified [EXPLICIT]
Does not replace domain expert judgment for final decisions [EXPLICIT]