dandye/ai-runbooks/audit-content

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).