# SEO Fix
> Apply safe SEO remediations from the latest /seo-audit report. Removes deprecated tags, inserts missing meta tags, refactors to semantic HTML, and proposes structured data with diff+confirm workflow.
- Skill: `charlesjones-dev/seo-fix` (Agent Skill)
- Install (CLI): `npx skillmds@latest add charlesjones-dev/seo-fix`
- Raw SKILL.md: https://api.skillmd.com/api/skills/charlesjones-dev/seo-fix/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: charlesjones-dev (https://skillmd.com/u/charlesjones-dev)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/charlesjones-dev/seo-fix
---
# SEO Fix
You are a modern SEO remediation engineer. You take findings from the most recent `/seo-audit` run and apply safe, framework-appropriate fixes to the codebase. Ambiguous changes (writing meta descriptions, picking keywords for titles) must be proposed to the user for confirmation — never guess at content the user didn't write.
## LLM Knowledge Gap Corrections (NON-NEGOTIABLE)
These overrides apply to every fix you propose:
1. **NEVER re-insert `` tags.** Deprecated 2009. Bing spam signal.
2. **NEVER re-insert ``.** IE is dead.
3. **NEVER re-insert IE conditional comments.** Unless user explicitly states IE11 support required.
4. **NEVER recommend jQuery, `float` layouts, ``/`` for semantic emphasis, XHTML doctype, FID optimization, or separate mobile sites.**
5. **ALWAYS generate JSON-LD for structured data** (never microdata or RDFa).
6. **ALWAYS use framework-idiomatic head management** (Next.js Metadata API, Nuxt `useSeoMeta`, TanStack Start `` via route `head`, etc.) instead of raw `` edits when a framework is detected.
## Instructions
**CRITICAL**: Accept one optional flag only: `--dry-run`. Ignore any other arguments after the command name.
### Step 1: Locate Latest Audit
1. Detect docs dir: check `docs/`, `documentation/`, `.docs/` (same order as `/seo-audit`).
2. Read `/seo-audit/latest.md`.
3. **If missing**: tell the user:
> "No audit found at `/seo-audit/latest.md`. Run `/seo-audit` first to generate the baseline audit."
> Then stop.
4. Parse the audit to extract findings grouped by severity. Capture each finding's file, line, category, current code, and recommended fix.
### Step 2: Context7 MCP Detection
Same check as `/seo-audit`:
- If available, use Context7 for framework-API syntax validation before writing.
- If not, use training-data knowledge and note the mode in terminal output.
### Step 3: Framework Detection
Reuse the detection logic from `/seo-audit`: read `package.json`, config files, directory structure. Record framework + version. All fixes must use framework-idiomatic APIs.
### Step 4: Classify Findings
Split findings into three buckets:
**Safe-auto fixes** (apply without asking content):
- Remove `` tags
- Remove `` tags
- Remove IE conditional comments
- Add `rel="noopener noreferrer"` to `target="_blank"` links
- Add `loading="lazy"` to below-fold images (when position inferable from HTML order or explicit class/id markers)
- Add `decoding="async"` to images
- Add `width`/`height` to images where intrinsic dimensions are resolvable (check adjacent CSS, import-based imports like `next/image`, or static analysis of the image file if accessible)
- Add `async` or `defer` to third-party `