/audit-content

type: Skill
name: audit-content
description: Comprehensive content quality and maintenance assessment. Evaluates documentation quality, relevance, maintenance needs, and provides actionable recommendations.
required_roles:
  scribe: roles/scribe.editor
personas: [information-architect, content-strategist, editor]
generated:
  by: process:google-labs-jules
  at: 2026-01-29T21:19:07Z

Content Audit Skill

Perform a comprehensive quality and maintenance assessment of documentation or content. This skill evaluates content against quality standards, checks for freshness, identifies maintenance needs, and provides actionable recommendations.

Inputs

• `PATH` - The directory or file path to audit (e.g., "/docs")
• `SEVERITY` - (Optional) Minimum severity level to report: "low", "medium", "high" (default: "medium")
• `CATEGORY` - (Optional) Categories to audit: "all", "quality", "relevance", "links", "metadata" (default: "all")
• `FIX_MODE` - (Optional) Boolean, whether to suggest or apply automated fixes where possible (default: false)

Workflow

Step 1: Inventory & Freshness Check

Scan the target `PATH` to list all content assets.

• Check "Last Modified" dates.
• Identify outdated content (e.g., > 6 months old).
• Verify author/owner metadata.

Step 2: Quality Assessment

Evaluate content against quality metrics:

• **Clarity & Readability**: Is the content easy to understand? (e.g., plain language).
• **Completeness**: Does it cover the topic sufficiently?
• **Accuracy**: Are there broken links, deprecated terms, or incorrect instructions?
• **Structure**: Does it follow standard templates and formatting?

Step 3: Issues & Recommendations

Generate a report of identified issues, categorized by severity:

• **High**: Broken paths, critical misinformation, missing required sections.
• **Medium**: Outdated styling, poor readability, minor inaccuracies.
• **Low**: Typos, inconsistent formatting.

If `FIX_MODE` is enabled, generate or apply suggestions for fixes.

Required Outputs

A `CONTENT_AUDIT_REPORT` in markdown format containing:

• **Summary**: Total files, overall quality score, critical issues count.
• **Detailed Findings**: Table of issues per file with severity.
• **Action Items**: Prioritized list of recommended changes.
• **Freshness Report**: List of stale or outdated documents.

Quick Reference

• **Purpose**: Support content maintenance planning and quality improvement.
• **Key Metrics**: Quality Score (0-100), Freshness (Age in days), Link Health (% valid).