Seo Kit

SEO Kit

Adds the high-impact SEO pieces to a site in one pass. Most of these are cheap to add and disproportionately valuable: rich link previews, Google entity data, and proper crawl/index directives.

What it adds

1. **` meta** — description, keywords, robots/googlebot, author`,

theme-color, and canonical.

1. Open Graph + Twitter Card — title/description/image so links unfurl nicely on

LinkedIn, Twitter/X, Slack, iMessage, Discord.

1. JSON-LD structured data — Person (for a portfolio/personal site) and/or

WebSite, so Google can build a proper entity.

1. sitemap.xml + robots.txt — for crawling/indexing (plus a small

generator script for SPAs with many routes).

How to apply it

1. Copy references/head.html content into the site's ``

(e.g. index.html for Vite/CRA, or app/layout ` / next/head` / the Metadata API for Next.js — adapt the tags to the framework's conventions).

1. Fill the placeholders (only required edit):

• {{DOMAIN}} → the canonical origin, e.g. https://example.com (no trailing slash)
• {{TITLE}} → page/site title (≤ ~60 chars)
• {{DESCRIPTION}} → 1–2 sentence summary (≤ ~155 chars)
• {{KEYWORDS}} → comma-separated, optional
• {{OG_IMAGE}} → an absolute URL to a 1200×630 image (see note below)
• {{NAME}}, {{JOB_TITLE}}, {{SAME_AS}} (social profile URLs) for the JSON-LD

1. Add references/robots.txt at the web root (public/robots.txt for Vite/Next),

replacing {{DOMAIN}}.

1. Add a sitemap: either drop in references/sitemap.xml (small static sites) or

run references/generate-sitemap.mjs for SPAs — pass your domain and routes and it writes public/sitemap.xml. Example: ``bash node generate-sitemap.mjs https://example.com / /about /projects/foo > public/sitemap.xml ``

1. Verify (see below).

Critical notes (tell the user)

• OG/Twitter images and og:url MUST be absolute URLs (https://domain/...),

not relative paths — crawlers won't resolve relative ones, so previews render blank. Set these only once the real domain is known.

• One canonical origin. Pick https://domain.com (or the www. variant) and use it

consistently in canonical, og:url, sitemap, and robots to avoid duplicate-content splits.

• OG image spec: 1200×630 px, ` tags here cover the home page; for per-route OG on a pure

SPA, consider prerendering or a meta-injection step.

Verifying

• Rich results / JSON-LD: https://search.google.com/test/rich-results
• Link preview: https://www.opengraph.xyz (or paste the URL in Slack/LinkedIn)
• Sitemap/robots: load /{robots.txt,sitemap.xml} → 200; submit the sitemap in

Google Search Console.

• Confirm `, meta[name=description], and link[rel=canonical]` are present in

the served HTML (View Source, not just devtools).

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Yahiasherif002
• Source: Yahiasherif002/claude-skills
• License: MIT

Install and usage instructions live in the source repository linked above.