fix
Installation
SKILL.md
fix (opt-in writer)
disable-model-invocation: true means the model can never trigger this on its own — only the user running /claude-seo-ai:fix. Writes happen only through the seo-fixer-writer subagent (the one agent with Write/Edit) and only after explicit confirmation.
Fixability classes (from each finding's fixable field — see schema/finding.schema.json)
- AUTO — deterministic, additive, machine-verifiable, low-semantic-risk. May be written (with diff + confirmation):
meta
viewport/charset/<html lang>; Tier-1 JSON-LD blocks;sameAs/@id/dateModified(from confirmed inputs only); robots.txt AI-crawler presets +Sitemap:line; self-referential canonical; hreflang link sets; OG/Twitter cards; imagewidth/height; XML sitemap entries;llms.txt(disclosure-gated). - PROPOSED — changes prose/meaning or is editorial; generate a draft diff and require per-item accept: generated
<title>and meta description, answer-block/TL;DR rewrites, internal-link insertions, heading restructuring, generated image alt text (titles, descriptions, and image alt are editorial messaging, not deterministic). - ADVISORY — never written: content/E-E-A-T rewrites, adding stats/citations/original data, Core Web Vitals/performance, rendering strategy, redirects/status codes, link-building, Merchant Center/GBP backend data.
Workflow
- Take the findings (from the last audit or a fresh one). Filter to
fixable: auto(+proposedif the user opts in). Honor--categoryto scope (schema|meta|robots|sitemap|hreflang|alt|canonical|social|llms). - For each, locate the exact insertion point in the user's files and build a unified diff (or new-file content). Resolve any required real-world inputs (e.g.
sameAsURLs, locale map, publish dates) by asking the user — never invent them. - Dry-run (default): print every diff grouped by file. Write nothing. Summarize what
fix(without--dry-run) would change. - On explicit confirmation (and only then): delegate to seo-fixer-writer to apply. Per-change or batch confirmation is the user's choice.