Creo SEO Content

creo-seo-content — Next.js content quality specialist

Content-specific SEO auditor. Runs as standalone or as the Phase 2 delegate of creo-seo. Scores each page on 5 content dimensions, detects AI-generated patterns, maps search intent, scores opportunity, and produces rewrite priorities with before/after examples.

Commands

Scoring

Composite 0–100 per page:

Content_Quality =
  (Humanity        × 0.30) +
  (Specificity     × 0.25) +
  (Structure       × 0.20) +
  (SEO_Compliance  × 0.15) +
  (Readability     × 0.10)

Publish threshold: ≥ 80 with zero Critical issues.

Audit flow

1. Load project profile from .claude/skills/creo-seo/creo-seo-{project_id}.md (shared with creo-seo skill). Fall back to fresh scan if missing.
2. Fetch page content — WebFetch for live URLs, Read for local MDX/TSX files.
3. Normalize text — strip HTML, extract main content, skip nav/footer.
4. Score 5 dimensions per references/content-quality-rubric.md (or shared ref in ../creo-seo/references/).
5. AI-pattern sweep per references/ai-pattern-detection.md — count phrases, vague words, boosters.
6. Structure analysis — H1/H2/H3 hierarchy, paragraph lengths, table/list presence.
7. Citability check per ../creo-seo/references/geo-citability.md — passages in 134–167 word range, 5-dimension scoring.
8. Intent classification — informational / navigational / transactional / commercial investigation.
9. Internal linking audit per ../creo-seo/references/internal-linking-recipe.md — count, anchors, cluster fit.
10. Output per-page report + rewrite priorities.

Search intent classification

4-class system:

Use intent to route:

• Informational → aim for citability + structured answers
• Commercial investigation → comparison tables, feature matrices
• Transactional → strong CTAs, trust signals, not just SEO
• Navigational → avoid SEO cannibalization of branded queries

Opportunity scoring (when GSC/keyword data available)

8-factor weighted score 0–100:

Opportunity =
  Volume(25%) + Position(20%) + Intent(20%) + Competition(15%)
  + Cluster(10%) + CTR(5%) + Freshness(5%) + Trend(5%)

Priority tiers:

• CRITICAL ≥ 80
• HIGH ≥ 65
• MEDIUM ≥ 45
• LOW ≥ 25
• SKIP < 25

Use with seo-google extension for live GSC data.

Writing patterns to enforce

Direct-answer opening (for AI citability)

Every H2 section must open with a 1–2 sentence direct answer before expanding. Pattern: "X is Y. It does Z."

Key Takeaways block (after intro, before first H2)

3–5 bullets of actual conclusions (not table of contents). AI summaries pull from here.

Mini-story injection

2–3 per long-form piece. Structure: named person + dates + outcome.

YouTube embed

≥ 1 relevant video per long-form article for multi-modal signal.

Content quality gates by page type

Reference library

Loaded on demand:

Report output

Save to {reports_path}/seo-content-{YYYYMMDD}-{HHMM}.md. Format:

# Content audit — {url}

**Composite score:** 68/100 (C)
**Publish status:** needs rework
**Intent:** commercial investigation (primary), informational (secondary)
**Opportunity score:** 72/100 (HIGH)

## Dimension breakdown
| Dimension | Score | Notes |
|-----------|------:|-------|
| Humanity | 58 | 12 AI phrases, 18 vague words in 1800w |
| Specificity | 62 | 2 stats only, no sources |
| Structure | 80 | Good H2s, paragraphs slightly long |
| SEO compliance | 75 | Keyword missing from first 100 words |
| Readability | 70 | Flesch 62, avg sentence 24 words |

## AI pattern flags (12 instances)
- "in today's digital world" — line 14
- "leverage" — line 28, 47
- ...

## Rewrite priorities (ranked by impact)
### 1. Opening paragraph — humanity + citability

BEFORE:
> {current opening}

AFTER:
> {rewritten opening with definition, stat, source}

### 2. Section 3 — specificity
...

## Internal linking gaps
- 2 of 3–5 links (below minimum)
- Missing pillar reference to /guide/podcast-hosting
- Orphan: 0 inbound links from other posts

## Next steps
1. Apply top 3 rewrites (est. score 68 → 82)
2. Add 1–2 internal links to pillar + related
3. Add 3 stats with citations to sections 2, 4, 6

Parallel execution

When called by creo-seo as part of /creo seo audit, run in parallel with Phase 3 + Phase 4. When called standalone, serial execution is fine.

Quality gates

• Every rewrite priority includes BEFORE + AFTER
• AI phrase flags are line-numbered
• Intent + opportunity scoring only fires when data is available; otherwise skip
• Reports saved to disk
• Scoring must be reproducible from refs (no magic constants in prose)