/astro-seo
Use when optimizing SEO for an Astro site — meta tags, Open Graph, JSON-LD structured data, sitemap/RSS, canonical URLs, hreflang, Core Web Vitals.
$ npx -y skills add fusengine/agents --skill astro-seo --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
- You can call itInvoke it directly when you want it.
- Slash command
/astro-seo
Context preview
The summary Claude sees to decide when to auto-load this skill.
Use when optimizing SEO for an Astro site — meta tags, Open Graph, JSON-LD structured data, sitemap/RSS, canonical URLs, hreflang, Core Web Vitals.
SKILL.md
astro-seo.SKILL.mdname: astro-seo
description: Use when optimizing SEO for an Astro site — meta tags, Open Graph, JSON-LD structured data, sitemap/RSS, canonical URLs, hreflang, Core Web Vitals.
versions:
astro: "7"
user-invocable: true
references: references/meta-tags.md, references/structured-data.md, references/sitemap-rss.md, references/canonical-hreflang.md, references/core-web-vitals.md, references/templates/seo-head.md, references/templates/json-ld.md
related-skills: astro-7, astro-content, astro-assets, astro-i18n
<objective> Implements SEO for Astro 7 sites: meta tags, Open Graph, and Twitter Cards via a reusable `<SEO />`/`<Head />` component; JSON-LD structured data injected with `set:html` (never string interpolation, to avoid XSS); `@astrojs/sitemap` and `@astrojs/rss` setup; robots.txt and canonical URLs built with `Astro.site`; hreflang for multilingual SEO; and Core Web Vitals optimization leveraging Astro's zero-JS-by-default output.
Does not cover locale routing mechanics beyond hreflang tag generation (astro-i18n), Content Layer schema design (astro-content), or image-specific optimization like `<Image />`/`<Picture />` (astro-assets) — those are separate skills. </objective>
Astro SEO
Complete SEO strategy for Astro 7 sites — zero JS by default makes Astro naturally SEO-friendly.
Agent Workflow (MANDATORY)
Before ANY implementation, use `TeamCreate` to spawn 3 agents:
1. **fuse-ai-pilot:explore-codebase** - Analyze existing layouts, head components, and metadata 2. **fuse-ai-pilot:research-expert** - Verify latest SEO best practices via Context7/Exa 3. **mcp__context7__query-docs** - Check Astro 7 sitemap/RSS integration docs
After implementation, run **fuse-ai-pilot:sniper** for validation.
---
Overview
When to Use
- Adding meta tags and Open Graph to any Astro page
- Generating JSON-LD structured data for rich snippets
- Setting up @astrojs/sitemap for search indexing
- Configuring RSS feeds with @astrojs/rss
- Creating robots.txt and canonical URL patterns
- Adding hreflang for multilingual SEO
- Measuring and improving Core Web Vitals
Why Astro for SEO
| Feature | Benefit | |---------|---------| | Zero JS by default | Pure HTML for crawlers, instant indexing | | Static output | Sub-second TTFB, top Core Web Vitals | | `Astro.site` | Canonical URL construction built-in | | Islands Architecture | Only hydrate interactive parts |
---
Core Concepts
Head Component Pattern
Create a reusable `<SEO />` or `<Head />` component accepting `title`, `description`, `og`, `canonical` props. Place in all layouts. Use `Astro.site` for absolute URL construction.
Canonical URLs
Always construct canonicals with `Astro.site`:
const canonical = new URL(Astro.url.pathname, Astro.site);
Structured Data
Inject JSON-LD via `<script type="application/ld+json" set:html={JSON.stringify(schema)} />`. Use `set:html` to avoid XSS — never template string interpolation.
---
Reference Guide
Concepts
| Topic | Reference | When to Consult | |-------|-----------|-----------------| | **Meta Tags & OG** | [meta-tags.md](references/meta-tags.md) | Setting up head metadata | | **JSON-LD** | [structured-data.md](references/structured-data.md) | Rich snippets, schema.org | | **Sitemap & RSS** | [sitemap-rss.md](references/sitemap-rss.md) | Search indexing, feeds | | **Canonical & hreflang** | [canonical-hreflang.md](references/canonical-hreflang.md) | Duplicate content, i18n | | **Core Web Vitals** | [core-web-vitals.md](references/core-web-vitals.md) | LCP, CLS, FID optimization |
Templates
| Template | When to Use | |----------|-------------| | [seo-head.md](references/templates/seo-head.md) | Reusable SEO head component | | [json-ld.md](references/templates/json-ld.md) | JSON-LD BlogPosting, WebSite schemas |
---
Best Practices
1. **One Head component** - Centralize all meta in a reusable component 2. **Absolute URLs** - Use `Astro.site` for og:image and canonicals 3. **`set:html` for JSON-LD** - Prevents XSS vulnerabilities 4. **sitemap + robots.txt** - Always configure both for crawlability 5. **hreflang on all locales** - Include x-default for language variants
Read more
name: astro-seo description: Use when optimizing SEO for an Astro site — meta tags, Open Graph, JSON-LD structured data, sitemap/RSS, canonical URLs, hreflang, Core Web Vitals. versions: astro: "7" user-invocable: true references: references/meta-tags.md, references/structured-data.md, references/sitemap-rss.md, references/canonical-hreflang.md, references/core-web-vitals.md, references/templates/seo-head.md, references/templates/json-ld.md related-skills: astro-7, astro-content, astro-assets, astro-i18n
<objective> Implements SEO for Astro 7 sites: meta tags, Open Graph, and Twitter Cards via a reusable `<SEO />`/`<Head />` component; JSON-LD structured data injected with `set:html` (never string interpolation, to avoid XSS); `@astrojs/sitemap` and `@astrojs/rss` setup; robots.txt and canonical URLs built with `Astro.site`; hreflang for multilingual SEO; and Core Web Vitals optimization leveraging Astro's zero-JS-by-default output.
Does not cover locale routing mechanics beyond hreflang tag generation (astro-i18n), Content Layer schema design (astro-content), or image-specific optimization like `<Image />`/`<Picture />` (astro-assets) — those are separate skills. </objective>
Astro SEO
Complete SEO strategy for Astro 7 sites — zero JS by default makes Astro naturally SEO-friendly.
Agent Workflow (MANDATORY)
Before ANY implementation, use `TeamCreate` to spawn 3 agents:
1. **fuse-ai-pilot:explore-codebase** - Analyze existing layouts, head components, and metadata 2. **fuse-ai-pilot:research-expert** - Verify latest SEO best practices via Context7/Exa 3. **mcp__context7__query-docs** - Check Astro 7 sitemap/RSS integration docs
After implementation, run **fuse-ai-pilot:sniper** for validation.
---
Overview
When to Use
- Adding meta tags and Open Graph to any Astro page
- Generating JSON-LD structured data for rich snippets
- Setting up @astrojs/sitemap for search indexing
- Configuring RSS feeds with @astrojs/rss
- Creating robots.txt and canonical URL patterns
- Adding hreflang for multilingual SEO
- Measuring and improving Core Web Vitals
Why Astro for SEO
| Feature | Benefit | |---------|---------| | Zero JS by default | Pure HTML for crawlers, instant indexing | | Static output | Sub-second TTFB, top Core Web Vitals | | `Astro.site` | Canonical URL construction built-in | | Islands Architecture | Only hydrate interactive parts |
---
Core Concepts
Head Component Pattern
Create a reusable `<SEO />` or `<Head />` component accepting `title`, `description`, `og`, `canonical` props. Place in all layouts. Use `Astro.site` for absolute URL construction.
Canonical URLs
Always construct canonicals with `Astro.site`:
const canonical = new URL(Astro.url.pathname, Astro.site);
Structured Data
Inject JSON-LD via `<script type="application/ld+json" set:html={JSON.stringify(schema)} />`. Use `set:html` to avoid XSS — never template string interpolation.
---
Reference Guide
Concepts
| Topic | Reference | When to Consult | |-------|-----------|-----------------| | **Meta Tags & OG** | [meta-tags.md](references/meta-tags.md) | Setting up head metadata | | **JSON-LD** | [structured-data.md](references/structured-data.md) | Rich snippets, schema.org | | **Sitemap & RSS** | [sitemap-rss.md](references/sitemap-rss.md) | Search indexing, feeds | | **Canonical & hreflang** | [canonical-hreflang.md](references/canonical-hreflang.md) | Duplicate content, i18n | | **Core Web Vitals** | [core-web-vitals.md](references/core-web-vitals.md) | LCP, CLS, FID optimization |
Templates
| Template | When to Use | |----------|-------------| | [seo-head.md](references/templates/seo-head.md) | Reusable SEO head component | | [json-ld.md](references/templates/json-ld.md) | JSON-LD BlogPosting, WebSite schemas |
---
Best Practices
1. **One Head component** - Centralize all meta in a reusable component 2. **Absolute URLs** - Use `Astro.site` for og:image and canonicals 3. **`set:html` for JSON-LD** - Prevents XSS vulnerabilities 4. **sitemap + robots.txt** - Always configure both for crawlability 5. **hreflang on all locales** - Include x-default for language variants
A plugin ecosystem that turns Claude Code into a supervised, multi-agent development environment.
Repo: fusengine/agents
Other skills on fusengine-agents.
- /agent-creator
Use when creating expert agents. Generates agent.md with frontmatter, hooks, required sections, and skill references.
Open skill - /apex-methodology
Use when starting ANY development task -- feature, bug fix, refactor, hotfix (triggers: implement, create, build, fix, add feature, refactor, develop).
Open skill - /brainstorming
Use when creating a feature/component or adding functionality. Fires BEFORE APEX Analyze to refine requirements via structured questioning.
Open skill - /challenge
Use before a root-cause, done/verified claim, irreversible action, or 2nd-time fix reaches the owner (APEX or plain conversation); also fires at every eLicit/Verify gate. Not for code correctness (use sniper).
Open skill - /code-quality
Use when validating code quality after modifications -- SOLID compliance, DRY duplication, linter errors, architecture violations. Do NOT use for functional verification (run verification FIRST, then code-quality).
Open skill - /elicitation
Use when an expert agent self-reviews and self-corrects code after the Execute phase, before sniper validation (BMAD-METHOD elicitation techniques).
Open skill