AgentSkillsCN

audit-content

全面评估内容质量与维护状况。从文档质量、内容相关性、维护需求等方面进行综合评估，并提供切实可行的改进建议。

SKILL.md
--- frontmatter
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]

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