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---2name: audit-content3description: Comprehensive content quality and maintenance assessment. Evaluates documentation quality, relevance, maintenance needs, and provides actionable recommendations.4---56# Content Audit Skill78Perform 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.910## Inputs1112- `PATH` - The directory or file path to audit (e.g., "/docs")13- `SEVERITY` - (Optional) Minimum severity level to report: "low", "medium", "high" (default: "medium")14- `CATEGORY` - (Optional) Categories to audit: "all", "quality", "relevance", "links", "metadata" (default: "all")15- `FIX_MODE` - (Optional) Boolean, whether to suggest or apply automated fixes where possible (default: false)1617## Workflow1819### Step 1: Inventory & Freshness Check2021Scan the target `PATH` to list all content assets.22- Check "Last Modified" dates.23- Identify outdated content (e.g., > 6 months old).24- Verify author/owner metadata.2526### Step 2: Quality Assessment2728Evaluate content against quality metrics:29- **Clarity & Readability**: Is the content easy to understand? (e.g., plain language).30- **Completeness**: Does it cover the topic sufficiently?31- **Accuracy**: Are there broken links, deprecated terms, or incorrect instructions?32- **Structure**: Does it follow standard templates and formatting?3334### Step 3: Issues & Recommendations3536Generate a report of identified issues, categorized by severity:37- **High**: Broken paths, critical misinformation, missing required sections.38- **Medium**: Outdated styling, poor readability, minor inaccuracies.39- **Low**: Typos, inconsistent formatting.4041If `FIX_MODE` is enabled, generate or apply suggestions for fixes.4243## Required Outputs4445A `CONTENT_AUDIT_REPORT` in markdown format containing:46- **Summary**: Total files, overall quality score, critical issues count.47- **Detailed Findings**: Table of issues per file with severity.48- **Action Items**: Prioritized list of recommended changes.49- **Freshness Report**: List of stale or outdated documents.5051## Quick Reference5253- **Purpose**: Support content maintenance planning and quality improvement.54- **Key Metrics**: Quality Score (0-100), Freshness (Age in days), Link Health (% valid).
dandye