blog-audit

Assess blog content quality and technical health across markdown or HTML files.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/captaindevv/blogs --skill blog-audit-captaindevv
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blog-audit
Source: https://github.com/captaindevv/blogs/tree/main/skills/blog-audit
Command: npx skills add https://github.com/captaindevv/blogs --skill blog-audit-captaindevv

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Conducts a thorough health assessment of a site's blog content to surface quality gaps, SEO issues, orphaned or stale posts, topic cannibalization, and readiness for AI citation so teams can prioritize improvements.

Core Features & Use Cases

  • Comprehensive Discovery: Finds blog files across common directories and extracts frontmatter metadata to build an audit scope.
  • Parallel Analysis Agents: Scores content quality, audits on-page SEO, validates schema, maps internal links to detect orphans and dead-ends, and assesses AI citation readiness.
  • Prioritized Action Queue: Produces per-post scores, cannibalization recommendations (merge/redirect/differentiate), and a ranked list of refresh actions with estimated effort for content teams.

Quick Start

Ask the assistant to "audit blog" to run a full-site blog health assessment and save the consolidated report to blog-audit-report.md.

Frequently Asked Questions about blog-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit blog content for SEO issues and stale posts?

Blog content is assessed for SEO issues and staleness by scanning markdown and HTML files across repository directories. The audit detects orphan pages, broken internal links, and stale content, generating per-post quality scores and a consolidated action queue.

What is topic cannibalization and how do I identify it in my blog?

Topic cannibalization happens when multiple posts compete for the same keywords. This Skill identifies cannibalization by analyzing content across all blog posts and mapping internal links, then recommending whether to merge, redirect, or differentiate overlapping articles.

How do I detect orphan pages and broken internal links in markdown files?

Orphan pages and broken internal links are detected by mapping internal link graphs across all site pages and markdown files. The analysis validates link structures, identifies dead-ends, and flags unlinked orphan pages for remediation in the final report.

How do I check my blog content for AI citation readiness?

AI citation readiness is checked by assessing blog content structure and schema markup to ensure AI systems can parse and reference it. This Skill audits schema validity and content quality to score how prepared your posts are for AI citation.

Can I run a site-wide blog health audit on existing markdown repositories?

A site-wide blog health audit can be run on existing markdown repositories. The Skill discovers blog files across common directories, extracts frontmatter metadata, and coordinates parallel analysis agents to assess technical health without requiring external dependencies.

What is the best way to prioritize blog content refresh actions?

Blog content refresh actions are best prioritized using a ranked action queue based on per-post quality scores and estimated effort. This Skill generates a prioritized list of refresh actions for content teams to address SEO gaps and stale content systematically.