# Adapto Seo Wire

> Make stored SEO metadata actually render — a one-time, consent-gated, framework-aware setup that wires a head-render layer (title, meta, OG/Twitter, JSON-LD) reading the _adapto_seo collection, plus generates llms.txt / llms-full.txt from your content inventory. Edits your app templates (never the read-client), only after you approve the exact changes.

- **Type:** Skill
- **Install:** `agentstack add skill-adaptocms-adapto-cms-agent-skills-adapto-seo-wire`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [adaptocms](https://agentstack.voostack.com/s/adaptocms)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [adaptocms](https://github.com/adaptocms)
- **Source:** https://github.com/adaptocms/adapto-cms-agent-skills/tree/main/plugin/skills/adapto-seo-wire
- **Website:** https://adaptocms.com/

## Install

```sh
agentstack add skill-adaptocms-adapto-cms-agent-skills-adapto-seo-wire
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# adapto:seo-wire

`adapto:content-upload` **stores** SEO metadata in `_adapto_seo`, but the starters render only ``. This
skill **makes it render**: a **one-time, per-project** setup that installs a head-render layer reading
`_adapto_seo` (emitting ``, meta description, OG/Twitter tags, and JSON-LD) and generates `llms.txt` /
`llms-full.txt` from your inventory. It is **consent-gated** (§3.12) and **only edits your own app templates** —
**never the read-client** ([forbidden-actions.md](../../shared/forbidden-actions.md); see
[seo-standards.md](../../shared/seo-standards.md) for what's rendered).

## When to use
- "Make my SEO/meta render", "wire up the head tags", "generate llms.txt", "the OG tags aren't showing".
- Once per project, after `adapto:content-upload` has written `_adapto_seo` items (or alongside the first upload).

## When not to use
- Storing metadata (that's `adapto:content-upload`, into `_adapto_seo`).
- Writing or uploading content → the content pipeline.
- Just checking the environment → `adapto:doctor`.

## Inputs
- The **scaffolded frontend** in the cwd, and its **framework** (Next / Astro / SvelteKit — detected as
  `adapto:doctor` does).
- The **`_adapto_seo`** collection (read at render time, by `target_slug`).
- **`inventory.md`** — the content list `llms.txt` is generated from.

## Outputs
- A **head-render layer** in the app's own templates (per framework: Next `generateMetadata` / Astro ``
  in the layout / SvelteKit ``) that reads `_adapto_seo` and emits title/description/OG/Twitter/JSON-LD.
- Generated **`llms.txt`** + **`llms-full.txt`** at the site root, from `inventory.md`.
- If you decline the edits: the exact per-framework **snippets** written to `.adapto/seo-render//`
  for you to paste, plus instructions. Nothing is changed without consent.
- **Next step:** restart the dev server and check a page's `` (and `/llms.txt`); re-run after big
  inventory changes to refresh `llms.txt`.

## Wiring (consent-gated — §3.12)
1. **Detect the framework** and locate the layout/head entry point + the static/`public` dir.
2. **Inform + show the exact files/diffs** you'd add/change (the head component + the `llms.txt` generator/route),
   noting it edits **app templates, not the read-client**. Ask as a **pickable question**:
   **`Yes, wire it`** / **`Just give me the snippets`** (plus free-form).
3. **On consent:** write the head-render layer (reads `_adapto_seo` by slug; falls back to the content title
   when no metadata exists) and generate `llms.txt`/`llms-full.txt` from `inventory.md`. Idempotent — re-running
   updates rather than duplicating.
4. **If declined:** write the snippets to `.adapto/seo-render//` + a short how-to; change nothing else.
5. **Then** tell the user to restart the dev server and verify the `` + `/llms.txt`. If **you** started
   the dev server, leave it running (conventions §14).

## Preconditions
- **Preflight** with the `adapto:doctor` checks (CLAUDE.md §3.14).
- A **scaffolded frontend** in the cwd (run `adapto:scaffold` first) on a supported framework.
- `_adapto_seo` should exist (provisioned by `adapto:schema-apply`); if absent, the layer still installs and
  simply renders title-only until metadata lands.
- `adapto` CLI `>= 0.0.7`. No auth/tenant needed (no CMS writes).

## Errors and recovery
- **Unsupported / undetected framework** → stop; emit the generic snippets to `.adapto/seo-render/` and explain.
- **Layout/head entry point not found** (starter changed) → don't guess-edit; show the user where to add the
  component and write the snippet.
- **User declines** → snippets-only path (above); never edit without consent.
- **`llms.txt` would expose unpublished/draft URLs** → include only published inventory entries; note the skip.

## Forbidden actions
- Never edit or replace the **read-client** (`src/lib/adapto-sdk.ts` + its paths) — app templates only, and
  only with consent (§3.11 / forbidden-actions.md).
- Never make host/file changes without explicit **§3.12 consent** — inform, show the diff, wait, then write.
- Never write CMS content (`mutates: false`).
- Never put draft-only or secret data into `llms.txt` / rendered tags.

## Source & license

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

- **Author:** [adaptocms](https://github.com/adaptocms)
- **Source:** [adaptocms/adapto-cms-agent-skills](https://github.com/adaptocms/adapto-cms-agent-skills)
- **License:** MIT
- **Homepage:** https://adaptocms.com/

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-adaptocms-adapto-cms-agent-skills-adapto-seo-wire
- Seller: https://agentstack.voostack.com/s/adaptocms
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.