paqad-ai
Version:
Spec-driven development framework — AI agents that think before they type
39 lines (25 loc) • 1.28 kB
Markdown
---
name: seo-optimizer
description: 'Revises drafts for search visibility (keyword placement, heading hierarchy, meta fields, internal links) without losing readability. Use when content-reviewer has passed the draft and the destination gets search traffic.'
---
# SEO Optimizer
## What It Does
Audits a near-final draft for SEO essentials and emits a checklist of concrete edits, never aesthetic suggestions. Preserves the writer's voice.
## Use This When
After `content-reviewer` has passed the draft and the destination supports search-driven traffic.
## Inputs
- The near-final draft.
- The target keyword set (primary + secondary).
- `references/seo-checklist.md`.
## Procedure
1. Run `scripts/audit-seo.sh <draft> <primary-kw>` to get heading depth, title-tag length, meta-description length, primary-keyword occurrences, and image-alt coverage.
2. Walk `references/seo-checklist.md` against the audit output.
3. Format edits per `assets/output.template.md`.
4. Validate with `scripts/lint-output.sh`.
## Output Contract
- Match `assets/output.template.md`: `## SEO Findings` (each with field/issue/fix) and `## Suggested Title/Meta`.
## Resources
- `references/seo-checklist.md`
- `scripts/audit-seo.sh`
- `scripts/lint-output.sh`
- `assets/output.template.md`