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).
1---2type: Skill3name: audit-content4description: Comprehensive content quality and maintenance assessment. Evaluates documentation quality, relevance, maintenance needs, and provides actionable recommendations.5required_roles:6 scribe: roles/scribe.editor7personas: [information-architect, content-strategist, editor]8generated:9 by: process:google-labs-jules10 at: 2026-01-29T21:19:07Z11---1213# Content Audit Skill1415Perform 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.1617## Inputs1819- `PATH` - The directory or file path to audit (e.g., "/docs")20- `SEVERITY` - (Optional) Minimum severity level to report: "low", "medium", "high" (default: "medium")21- `CATEGORY` - (Optional) Categories to audit: "all", "quality", "relevance", "links", "metadata" (default: "all")22- `FIX_MODE` - (Optional) Boolean, whether to suggest or apply automated fixes where possible (default: false)2324## Workflow2526### Step 1: Inventory & Freshness Check2728Scan the target `PATH` to list all content assets.29- Check "Last Modified" dates.30- Identify outdated content (e.g., > 6 months old).31- Verify author/owner metadata.3233### Step 2: Quality Assessment3435Evaluate content against quality metrics:36- **Clarity & Readability**: Is the content easy to understand? (e.g., plain language).37- **Completeness**: Does it cover the topic sufficiently?38- **Accuracy**: Are there broken links, deprecated terms, or incorrect instructions?39- **Structure**: Does it follow standard templates and formatting?4041### Step 3: Issues & Recommendations4243Generate a report of identified issues, categorized by severity:44- **High**: Broken paths, critical misinformation, missing required sections.45- **Medium**: Outdated styling, poor readability, minor inaccuracies.46- **Low**: Typos, inconsistent formatting.4748If `FIX_MODE` is enabled, generate or apply suggestions for fixes.4950## Required Outputs5152A `CONTENT_AUDIT_REPORT` in markdown format containing:53- **Summary**: Total files, overall quality score, critical issues count.54- **Detailed Findings**: Table of issues per file with severity.55- **Action Items**: Prioritized list of recommended changes.56- **Freshness Report**: List of stale or outdated documents.5758## Quick Reference5960- **Purpose**: Support content maintenance planning and quality improvement.61- **Key Metrics**: Quality Score (0-100), Freshness (Age in days), Link Health (% valid).
dandye