content-analyze-gaps

name	content-analyze-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.