blog-audit

Audit markdown blog collections for quality, orphan pages, and SEO metrics.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Performs a full-site assessment to find low-quality posts, orphan pages, topic cannibalization, stale content, broken links, and gaps in AI citation readiness so teams can prioritize content work and reduce SEO risk.

Core Features & Use Cases

  • Discovery: Scans common blog folders and detects markdown/html posts and blog-like frontmatter across the repo.
  • Parallel Analysis Agents: Runs content quality, SEO, schema validation, link health, freshness, and AI-readiness analyses in parallel to generate per-post scores.
  • Topic & Link Analysis: Detects keyword cannibalization and builds an internal link graph to surface orphan and dead-end pages with link recommendations.
  • Reporting & Action Queue: Produces a site-wide markdown report with summary dashboard, per-post scoring breakdowns, prioritized action queue, and cannibalization/orphan recommendations; saves output to blog-audit-report.md.
  • Use Case: Ideal for content teams preparing a site migration, improving SEO, or preparing posts for LLM citation and knowledge ingestion.

Quick Start

Run a full-site blog audit and save the results to blog-audit-report.md in the project root.

Frequently Asked Questions about blog-audit

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

FAQPage Schema
How do I audit my blog for content quality and SEO issues?

You can audit blog content quality by scanning markdown and static-site directories to score posts, map internal links, detect topic cannibalization, and flag prioritized fixes. The tool outputs a comprehensive markdown report to blog-audit-report.md.

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

Topic cannibalization occurs when multiple posts compete for the same keywords. A site-wide blog audit detects this by analyzing content across directories, mapping keyword overlaps, and generating prioritized recommendations to fix competing pages.

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

Finding orphan pages involves building a directed internal link graph from your blog content. A site-wide audit parses markdown directories, computes link relationships, and surfaces orphan and dead-end pages with actionable link recommendations in a markdown report.

Can I check if my blog posts are ready for AI citation and LLM ingestion?

Yes, you can check AI citation readiness by running a parallel analysis on your blog posts. The audit evaluates content structure and schema validation across markdown directories to determine if your posts are optimized for LLM citation and knowledge ingestion.

Does a site-wide blog audit work with markdown files in custom directories?

Yes, a site-wide blog audit works with markdown files in custom directories. It detects posts and blog-like frontmatter across common folders like content/, posts/, blog/, and pages/, parsing frontmatter to compute freshness and SEO metrics.

What is the best way to identify stale content during a site migration?

The best way to identify stale content is to run a full-site assessment that computes freshness metrics for each post. By parsing frontmatter and content, the audit flags outdated posts and generates a prioritized action queue for site migration.