Content Quality Auditor Skill

Description

Activate this skill when the user wants to audit, review, or score a website, codebase, URL, page, or content set for SEO and AEO performance. Trigger phrases include: "audit this content", "SEO review", "AEO audit", "check this page", "score this article", "content auditor", "what's wrong with this content", "review this landing page", "analyze content quality".

Input Format

{
  "content": "string — paste raw content, provide a URL, or provide a project path",
  "input_type": "text | url | website | codebase",
  "primary_keyword": "string — the main keyword this content should rank for",
  "secondary_keywords": ["string"],
  "content_type": "landing-page | blog-post | pillar-page | product-page",
  "word_count_target": "integer — expected word count, default 1500",
  "business_context": "string — optional description of the business and conversion goal",
  "existing_content": ["string — optional URLs or titles already published"]
}

For a new project, default to a full website/codebase audit before recommending new content. If the user has not supplied target keywords, identify candidate keywords from the site and ask which ones matter before finalizing the content strategy. If the user does not know, continue with a clearly labelled fallback strategy based on observed search intent.

Read references/seo-audit-checklist.md for the audit dimensions, evidence rules, and audit-to-implementation loop.

Scoring System

All scores are out of 100. Use these thresholds consistently:

Output Structure

The skill must always produce output in this exact format:

# Content Quality Audit Report

## Summary

| Metric              | Score     | Status  |
|---------------------|-----------|---------|
| Overall Score       | [X/100]   | [label] |
| SEO Score           | [X/100]   | [label] |
| AEO Score           | [X/100]   | [label] |
| Readability Score   | [X/100]   | [label] |

**Verdict:** [One sentence summary of the content's current state
and the single most important fix needed.]

---

## SEO Report

### Score: [X/100] — [Status Label]

#### ✅ Passing Checks
- [Check name]: [what was found]
- [Check name]: [what was found]

#### ❌ Critical Issues — Fix Before Publishing

**Issue:** [Specific problem, e.g. "Primary keyword missing from H1"]
**Severity:** Critical
**Fix:** [Exact instruction, e.g. "Rewrite H1 to include '[keyword]'
naturally within the first 6 words"]

**Issue:** [Specific problem]
**Severity:** Critical
**Fix:** [Exact instruction]

#### ⚠️ Warnings — Fix Soon

**Issue:** [Specific problem]
**Severity:** Medium
**Fix:** [Exact instruction]

#### Keyword Analysis

| Keyword              | Found | Occurrences | Density | Target   | Status  |
|----------------------|-------|-------------|---------|----------|---------|
| [primary keyword]    | Yes/No| [n]         | [x.x%]  | Natural use | ✅ / ❌ |
| [secondary keyword]  | Yes/No| [n]         | [x.x%]  | Natural use | ✅ / ❌ |

#### Heading Structure

| Heading | Text                        | Contains Keyword | Status  |
|---------|-----------------------------|------------------|---------|
| H1      | [heading text]              | Yes/No           | ✅ / ❌ |
| H2 #1   | [heading text]              | Yes/No           | ✅ / ❌ |
| H2 #2   | [heading text]              | Yes/No           | ✅ / ❌ |

H1 count: [n] — must be exactly 1
H2 count: [n] — recommended 4–6 for blog posts
H3 count: [n] — should only appear inside H2 sections

#### Meta Elements

| Element          | Found    | Content                          | Status  |
|------------------|----------|----------------------------------|---------|
| Title Tag        | Yes/No   | [content or "missing"]           | ✅ / ❌ |
| Meta Description | Yes/No   | [content or "missing"]           | ✅ / ❌ |
| Title Length     | [n] chars| Target: 50–60 characters         | ✅ / ❌ |
| Meta Length      | [n] chars| Target: 140–160 characters       | ✅ / ❌ |
| Keyword in Title | Yes/No   | —                                | ✅ / ❌ |

#### Word Count


…