blog-audit

Audit markdown blog content for quality, SEO, freshness, and link health.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects and prioritizes fixes for widespread blog quality issues that are hard to spot at scale, including poor content quality, SEO gaps, orphan pages, topic cannibalization, stale posts, broken links, and lack of AI citation readiness. It centralizes visibility into site-wide content health so teams can focus limited editorial resources on the highest-impact work.

Core Features & Use Cases

  • Automated discovery of markdown and HTML blog files across common content folders and frontmatter-based blog files when needed.
  • Parallel analysis agents for content quality, SEO, schema validation, link health, freshness, and AI citation readiness; produces per-post scores and structured diagnostics.
  • Site intelligence including internal link graphs, orphan and dead-end detection, topic cannibalization detection with merge/redirect/differentiate recommendations, and a prioritized action queue.
  • Use Case: Run when you need a single, actionable audit of a static site or markdown blog directory to plan editorial refreshes, redirects, and SEO fixes.

Quick Start

Audit the entire blog directory, score every post, and save a prioritized 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 perform a full-site SEO audit on a markdown blog directory?

To audit a static site or markdown blog directory, the system automatically discovers content files across common folders, runs parallel analysis on content quality, SEO, schema, and link health, and outputs a comprehensive markdown report with per-post metrics and internal link graphs.

What is topic cannibalization detection and how does it identify duplicate content?

Topic cannibalization detection identifies multiple posts competing for the same search terms. The audit generates cannibalization tables with merge, redirect, or differentiate recommendations so editorial teams can consolidate ranking authority.

How do I find orphan pages and broken internal links in a static site?

Finding orphan pages and broken links in a static site involves mapping the internal link graph to detect unlinked or dead-end pages. The audit processes your blog directory to identify these structural issues alongside stale posts and content quality gaps.

Does the blog audit work with static sites and frontmatter-based markdown files?

Yes, the blog audit supports static sites and markdown-based content directories, including frontmatter-based blog files. It uses file-globbing across common content folders to discover files and perform comprehensive site-wide analysis.

How do I assess content freshness and AI citation readiness for existing blog posts?

Assessing content freshness and AI citation readiness involves scoring each post against staleness criteria and AI visibility factors. The audit generates per-post scores for both metrics, highlighting stale content that needs editorial refreshes to maintain search and AI relevance.