fix

Opt-in fixer (the /claude-seo-ai:fix command). Applies the safe, deterministic SEO/AI-search fixes from an audit to the user's code — meta viewport/charset/lang, JSON-LD, robots.txt AI directives, hreflang, sitemaps, OG/Twitter cards, image dimensions, canonical, llms.txt. Dry-run preview by default; writes only after explicit per-change confirmation. Runs only when the user invokes it — never auto-triggered.

Jump to install

Repository: Hainrixz/claude-seo-ai
Last source activity: June 1, 2026 at 18:28
Detected SKILL.md language: English
Stars: 42
Forks: 5

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/Hainrixz/claude-seo-ai --skill fix

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

audit

Audit a website or web codebase for SEO and AI-search (GEO/AEO) — produces two independent 0-100 scores (Search SEO + AI Visibility) plus a prioritized, evidence-backed report. Read-only; never writes files. Use when the user asks to audit, analyze, check, or score a site's SEO, structured data/schema, meta tags, Core Web Vitals, robots.txt, sitemaps, or llms.txt, or how it ranks in Google and is cited by AI engines (ChatGPT, Perplexity, Google AI Overviews, Gemini, Claude).

2026-06-01

geo

Analyze and score only a page's AI-search visibility (GEO/AEO) — answer extractability, fact density, AI-crawler access, entity linking, and llms.txt — and report an AI Visibility score with a citability breakdown. Read-only. Use for "will AI engines cite this?", GEO/AEO, or ChatGPT/Perplexity/Google AI Overviews/Gemini optimization.

2026-06-01

score

Recompute and display the two scores (Search SEO + AI Visibility) from the most recent audit's findings, without re-crawling. Use to re-show or refresh the scores after an audit, or to score a saved findings JSON file.

2026-06-01

View all from this repository

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; image width/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

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. sameAs URLs, 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.

Safety (hard rules)

Dry-run is the default; writing requires the user to drop --dry-run and confirm.

Git-aware: refuse to write to a dirty working tree unless --force; prefer creating/using a branch. Detect via git status --porcelain.

Backup every file before first modification to ${CLAUDE_PLUGIN_DATA}/backups/<timestamp>/<path>.

Idempotent: detect existing tags/blocks; update in place, never duplicate (re-running fix produces no new diffs once applied).

Re-verify: after writing, re-run the finding's verification.assertion (e.g. scripts/validate-jsonld.mjs) and report pass/fail per change.

Never touch .git/, .env/secrets, lockfiles, or files outside the project root.

No fabrication: never write invented statistics, citations, dates (no backdating dateModified), credentials, or identity links.

fix (opt-in writer)

Fixability classes (from each finding's fixable field — see schema/finding.schema.json)

Workflow

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.

Safety (hard rules)

Dry-run is the default; writing requires the user to drop --dry-run and confirm.

Git-aware: refuse to write to a dirty working tree unless --force; prefer creating/using a branch. Detect via git status --porcelain.

Backup every file before first modification to ${CLAUDE_PLUGIN_DATA}/backups/<timestamp>/<path>.

Idempotent: detect existing tags/blocks; update in place, never duplicate (re-running fix produces no new diffs once applied).

Re-verify: after writing, re-run the finding's verification.assertion (e.g. scripts/validate-jsonld.mjs) and report pass/fail per change.

Never touch .git/, .env/secrets, lockfiles, or files outside the project root.

No fabrication: never write invented statistics, citations, dates (no backdating dateModified), credentials, or identity links.

fix

Install options

Review the source files

fix (opt-in writer)

Fixability classes (from each finding's `fixable` field — see `schema/finding.schema.json`)

Workflow

Safety (hard rules)

fix (opt-in writer)

Fixability classes (from each finding's `fixable` field — see `schema/finding.schema.json`)

Workflow

Safety (hard rules)

name	fix
description	Opt-in fixer (the /claude-seo-ai:fix command). Applies the safe, deterministic SEO/AI-search fixes from an audit to the user's code — meta viewport/charset/lang, JSON-LD, robots.txt AI directives, hreflang, sitemaps, OG/Twitter cards, image dimensions, canonical, llms.txt. Dry-run preview by default; writes only after explicit per-change confirmation. Runs only when the user invokes it — never auto-triggered.
disable-model-invocation	true
argument-hint	<url\|path> [--category schema\|meta\|robots\|sitemap\|hreflang\|alt\|canonical\|social\|llms] [--dry-run]
allowed-tools	Read, Grep, Glob, Bash, Task

fix

Source facts

Install options

Review the source files

More from this repository

More from this repository

fix (opt-in writer)

Fixability classes (from each finding's fixable field — see schema/finding.schema.json)

Workflow

Safety (hard rules)

fix (opt-in writer)

Fixability classes (from each finding's fixable field — see schema/finding.schema.json)

Workflow

Safety (hard rules)

Fixability classes (from each finding's `fixable` field — see `schema/finding.schema.json`)

Fixability classes (from each finding's `fixable` field — see `schema/finding.schema.json`)