Analyze Content Gaps

---
name: analyze-content-gaps
description: Identify content gaps and organizational opportunities. Analyzes missing content areas, redundancies, and consolidation opportunities.
required_roles:
  scribe: roles/scribe.viewer
personas: [information-architect, content-strategist, product-manager]
---

# Analyze Content Gaps Skill

Identify missing, redundant, or underperforming content within a documentation set. This skill compares existing content against user needs and competitive benchmarks to find opportunities for improvement.

## Inputs

- `PATH` - The content documentation to analyze (e.g., "/documentation")
- `USER_NEEDS` - (Optional) Boolean, whether to map against user search queries or support tickets (default: true)
- `COMPETITIVE_ANALYSIS` - (Optional) Boolean, whether to compare against industry standards or competitors (default: false)

## Workflow

### Step 1: Baseline Assessment

Map the current state of content at `PATH`.
- What topics are covered?
- What is the depth of coverage?

### Step 2: Needs Analysis

Determine what *should* be covered.
- **User Needs**: Analyze search logs, support tickets, or user stories (if `USER_NEEDS` is true).
- **Standards**: Compare against standard frameworks or requirements.
- **Competitors**: Compare against competitor documentation (if `COMPETITIVE_ANALYSIS` is true).

### Step 3: Gap Identification

Compare Baseline vs. Needs.
- **Missing**: Topics required but not present.
- **Thin**: Topics present but lacking detail.
- **Redundant**: Multiple pages covering the same topic unnecessarily.
- **Outdated**: Content that no longer matches current needs.

### Step 4: Strategic Recommendations

Prioritize gaps based on impact and effort.

## Required Outputs

A `GAP_ANALYSIS_REPORT` in markdown format containing:
- **Missing Topics**: List of high-priority new content to create.
- **Improvement Areas**: List of existing content needing expansion.
- **Consolidation Targets**: List of redundant content to merge.
- **Strategic Roadmap**: Recommended order of execution.

## Quick Reference

- **Purpose**: Align content with user needs and business goals.
- **Outcome**: Actionable content strategy roadmap.