AgentSkillsCN

content-audit

分析基于Jekyll的静态网站中的Markdown内容，检查Front Matter、页面结构、链接、可读性以及SEO质量。

SKILL.md
--- frontmatter
name: content-audit
description: >
  Analyzes Markdown content in Jekyll-based static sites, checking frontmatter,
  structure, links, readability, and SEO quality.

Content Audit Skill

Purpose

Improve the clarity, consistency, and search visibility of Markdown files in a Jekyll project.
The skill inspects frontmatter, headings, links, images, and overall text quality.

When to Use This Skill

  • •Reviewing new blog posts before publishing
  • •Auditing existing pages for consistency
  • •Improving SEO and internal linking
  • •Ensuring accessibility and clean structure

Instructions

1. Collect Markdown Files

  • •Load all .md files from _posts, _pages, and the project root.
  • •Ignore files inside _site or other build output directories.

2. Analyze Frontmatter

For each file:

  • •Check for required fields: title, description, date, tags.
  • •Detect missing, duplicated, or inconsistent metadata.
  • •Suggest improvements to naming, tagging, and permalink structure.

3. Evaluate Content Structure

  • •Inspect heading hierarchy (h1 → h2 → h3).
  • •Identify overly long sections or missing introductions.
  • •Suggest clearer, more concise phrasing where appropriate.

4. Check Internal and External Links

  • •Verify internal links match existing pages or posts.
  • •Flag broken or unreachable external URLs.
  • •Recommend internal cross-links to related content.

5. Audit Images

  • •Ensure each image has an alt attribute.
  • •Detect missing or unused image references.
  • •Suggest more descriptive alt text when needed.

6. SEO and Readability Review

  • •Highlight passive voice, long sentences, or unclear passages.
  • •Suggest meta descriptions based on the content.
  • •Recommend keywords