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---5
6# Content Audit Skill
7
8Perform 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.
9
10## Inputs
11
12- `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)
16
17## Workflow
18
19### Step 1: Inventory & Freshness Check
20
21Scan 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.
25
26### Step 2: Quality Assessment
27
28Evaluate 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?
33
34### Step 3: Issues & Recommendations
35
36Generate 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.
40
41If `FIX_MODE` is enabled, generate or apply suggestions for fixes.
42
43## Required Outputs
44
45A `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.
50
51## Quick Reference
52
53- **Purpose**: Support content maintenance planning and quality improvement.
54- **Key Metrics**: Quality Score (0-100), Freshness (Age in days), Link Health (% valid).
majiayu000