Full-site blog health assessment scanning all blog files for quality scores, orphan pages, topic cannibalization, stale content, and AI citation readiness.

MITAuto-check passedMarketing & SEO

Install Blog Audit

skills CLI
$ npx skills add Infrasity-Labs/dev-gtm-claude-skills --skill blog-audit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Infrasity-Labs/dev-gtm-claude-skills blog-audit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Infrasity-Labs/dev-gtm-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/blog-audit .claude/skills/blog-audit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
blog-audit
GitHub stars
136
Token cost
~1.8k tokens
SKILL.md length
696 words
Files
1
Skills in repo
26
Repo updated
First seen
Licence
MIT

At a glance

Full-site blog health assessment scanning all blog files for quality scores, orphan pages, topic cannibalization, stale content, and AI citation readiness.

  • Works in 7 steps: Discover Blog Files → Parallel Analysis → Topic Cannibalization Detection → …
  • User says audit blog
  • SKILL.md covers Audit Process and Cross-reference
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Blog Audit is an agent skill from Infrasity-Labs/dev-gtm-claude-skills. Full-site blog health assessment scanning all blog files for quality scores, orphan pages, topic cannibalization, stale content, and AI citation readiness. Spawns parallel subagents for comprehensive analysis. Produces per-post scores and a prioritized action queue. Use when user says "audit blog", "blog audit", "site audit", "blog health", "audit all posts", "check all blogs".

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering AI search optimization, SEO audit and Subagents. The repository describes itself as: Open-source Claude skills for GEO, AI discoverability, and developer GTM workflows. Built for developer-focused companies that want their documentation to be found, parsed, and… The licence is MIT.

When your agent uses it

  • User says audit blog
  • Audit all posts
  • Check all blogs

Example prompts

  • “audit blog”
  • “blog audit”
  • “site audit”
  • “/blog-audit”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Discover Blog Files
  2. Parallel Analysis
  3. Topic Cannibalization Detection
  4. Orphan Page Detection
  5. Stale Content Detection
  6. Generate Site-Wide Report
  7. Save Report

What it can do on your machine

Read from SKILL.md and the folder at commit 02cfefb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Blog Audit loads about 1.8k tokens when it runs. Until then it costs about 98 tokens; SKILL.md has 696 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~98
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Infrasity-Labs/dev-gtm-claude-skills at commit 02cfefb, republished under its MIT licence (© Infrasity-Labs). 696 words, ~1,823 tokens.

Download SKILL.mdSave it as .claude/skills/blog-audit/SKILL.md (or your agent's skills folder).
name
blog-audit
description
Full-site blog health assessment scanning all blog files for quality scores, orphan pages, topic cannibalization, stale content, and AI citation readiness. Spawns parallel subagents for comprehensive analysis. Produces per-post scores and a prioritized action queue. Use when user says "audit blog", "blog audit", "site audit", "blog health", "audit all posts", "check all blogs".
user-invokable
true
argument-hint
[directory]

Blog Audit: Full-Site Health Assessment

Performs a comprehensive blog health assessment across all posts in the project. Scans for quality scores, orphan pages, topic cannibalization, stale content, and AI citation readiness. Uses parallel subagents for efficient analysis and produces a prioritized action queue.

Audit Process

Step 1: Discover Blog Files

Scan the project for all blog content files:

  • Glob for *.md, *.mdx, *.html in common blog directories
  • Common paths to check:
    • content/
    • posts/
    • blog/
    • src/content/
    • _posts/
    • pages/blog/
    • articles/
    • src/pages/blog/
  • Filter out non-blog files: README, CHANGELOG, LICENSE, config files, SKILL.md, package.json, node_modules
  • Report: "Found N blog files in [directories]"

If no blog files are found in standard locations, search the entire project root for markdown files with blog-like frontmatter (title, date, description).

Step 2: Parallel Analysis

Spawn subagents via the Task tool for parallel processing across all discovered blog files:

Content Quality Agent
  • Score each post on the 30-point content quality scale
  • Check paragraph length (target 40-80 words, hard limit 150)
  • Check sentence length (target 15-20 words)
  • Evaluate heading structure and question-format headings
  • Assess readability (Flesch Reading Ease 60-70 target)
SEO Optimization Agent
  • Check on-page SEO elements per post:
    • Title tag length (50-60 chars)
    • Meta description (150-160 chars, includes statistic)
    • H1 presence and uniqueness
    • Image alt text coverage
    • Internal and external link counts
    • URL slug quality
Schema Validation Agent
  • Detect structured data across all posts
  • Validate BlogPosting schema completeness
  • Check FAQ schema presence and format
  • Verify dateModified matches lastUpdated frontmatter
  • Flag missing or malformed schema
  • Map internal links across all posts
  • Build a directed link graph
  • Detect orphan pages (zero inbound internal links)
  • Detect dead-end pages (zero outbound internal links)
  • Check for broken internal link targets
  • Recommend bidirectional link opportunities
Freshness Check Agent
  • Read lastUpdated or dateModified from each post's frontmatter
  • Calculate days since last update
  • Flag posts not updated in 90+ days
  • Categorize by refresh priority
AI Readiness Agent
  • Score each post for AI citation readiness
  • Check passage-level citability (120-180 word sections)
  • Evaluate Q&A formatting and entity clarity
  • Check for TL;DR boxes and citation capsules
  • Assess AI crawler accessibility
Step 3: Topic Cannibalization Detection

Analyze across all posts for keyword competition:

  1. Extract primary keyword/topic from each post:
    • Title text
    • H1 heading
    • Meta description
    • First paragraph
  2. Normalize keywords (lowercase, remove stop words)
  3. Detect multiple posts targeting the same primary keyword
  4. Flag competing posts with one of these recommendations:
    • Merge: Combine two weak posts into one strong post
    • Redirect: 301 redirect the weaker post to the stronger one
    • Differentiate: Adjust focus so posts target distinct intents
Show full SKILL.md (275 more words)Show less
Step 4: Orphan Page Detection

Build and analyze the internal link graph:

  1. For each blog post, extract all internal links (relative and absolute)
  2. Build an adjacency map: { page -> [pages it links to] }
  3. Build a reverse map: { page -> [pages linking to it] }
  4. Identify orphan pages: posts with zero inbound internal links
  5. Identify dead-end pages: posts with zero outbound internal links
  6. For each orphan, recommend 2-3 existing posts that should link to it based on topic relevance
Step 5: Stale Content Detection

Audit content freshness across all posts:

  1. Read frontmatter fields: lastUpdated, dateModified, date, updated
  2. Calculate days since last update for each post
  3. Categorize by refresh priority:
    • High (>180 days): Likely outdated, statistics may be stale
    • Medium (90-180 days): Review for accuracy, update statistics
    • Low (<90 days): Recently updated, no immediate action
  4. Estimate refresh effort per post:
    • Light refresh: Update statistics, check links (1-2 hours)
    • Moderate refresh: Rewrite sections, add new data (3-4 hours)
    • Heavy refresh: Full rewrite recommended (5+ hours)
Step 6: Generate Site-Wide Report

Aggregate all results into a comprehensive report:

Summary Dashboard
## Blog Audit Report

**Audit Date:** [date]
**Total Posts:** N
**Average Score:** XX/100

### Health Overview
| Metric | Count |
|--------|-------|
| Posts Scoring 90+ (Excellent) | N |
| Posts Scoring 70-89 (Good) | N |
| Posts Scoring 50-69 (Needs Work) | N |
| Posts Scoring <50 (Poor) | N |
| Orphan Pages | N |
| Dead-End Pages | N |
| Cannibalization Issues | N |
| Stale Content (90+ days) | N |
Per-Post Table
### Per-Post Scores
| Post | Score | Content | SEO | E-E-A-T | Technical | AI Citation | Issues |
|------|-------|---------|-----|---------|-----------|-------------|--------|
| [filename] | XX/100 | X/25 | X/20 | X/20 | X/15 | X/20 | [count] |
Prioritized Action Queue
### Prioritized Action Queue (Lowest Score First)
| Priority | Post | Score | Top Issue | Recommended Action |
|----------|------|-------|-----------|--------------------|
| 1 | [file] | XX | [issue] | [action] |
| 2 | [file] | XX | [issue] | [action] |
Cannibalization Report
### Topic Cannibalization
| Keyword | Competing Posts | Recommendation |
|---------|----------------|----------------|
| [keyword] | post-a.md, post-b.md | Merge / Redirect / Differentiate |
Orphan Pages
### Orphan Pages (No Inbound Links)
| Page | Inbound Links | Recommended Link Sources |
|------|---------------|--------------------------|
| [file] | 0 | post-a.md, post-b.md, post-c.md |
Stale Content
### Stale Content
| Post | Last Updated | Days Stale | Priority | Refresh Effort |
|------|-------------|------------|----------|----------------|
| [file] | [date] | [N] | High/Med/Low | Light/Moderate/Heavy |
Step 7: Save Report

Save the complete report to blog-audit-report.md in the project root.

After saving, inform the user:

  • Report location: [project-root]/blog-audit-report.md
  • Summary of findings (total posts, average score, critical issues count)
  • Suggest running /blog analyze <file> on the lowest-scoring post first
  • Suggest running /blog geo <file> for AI citation optimization on key posts

Cross-reference

For evidence-led audit prompts beyond this site-wide health pass, see /blog flow optimize (visibility, CTR, schema, extraction audits) and /blog flow win (dual-surface scorecard, conversion audit).

© Infrasity-Labs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/blog-audit of Infrasity-Labs/dev-gtm-claude-skills.

Open the folder on GitHubat commit 02cfefb

Compare with similar skills

Blog Audit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Blog Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Blog Audit this skillInfrasity-Labs/dev-gtm-claude-skills136—~1.8kAutomated safety check: PassMIT
SEO AuditAgriciDaniel/codex-seo7992 repos~1.9kAutomated safety check: PassMIT
Geo Auditzubair-trabzada/geo-seo-claude11k—~3.1kAutomated safety check: NotesMIT
Geo Auditsickn33/agentic-awesome-skills47k1 repos~3.4kAutomated safety check: NotesMIT
GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude11k—~2.8kAutomated safety check: NotesMIT
GEO Monthly Delta Reportzubair-trabzada/geo-seo-claude11k—~2.4kAutomated safety check: NotesMIT

Similar skills

  • SEO Audit

    AgriciDaniel/codex-seo

    Full website SEO audit with parallel subagent delegation. An agent skill from AgriciDaniel/codex-seo.

    799 GitHub starsUsed in 2 repos~1.9k tokens
    Marketing & SEOAuto-check passed
  • Geo Audit

    zubair-trabzada/geo-seo-claude

    Full website GEO+SEO audit with parallel subagent delegation.

    11k GitHub stars~3.1k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes
  • Geo Audit

    sickn33/agentic-awesome-skills

    Full website GEO+SEO audit with parallel subagent delegation.

    47k GitHub starsUsed in 1 repo~3.4k tokens
    Marketing & SEOAuto-check: notes
  • GEO-First SEO Audit Tool

    zubair-trabzada/geo-seo-claude

    Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.

    11k GitHub stars~2.8k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes
  • GEO Monthly Delta Report

    zubair-trabzada/geo-seo-claude

    Compares a baseline and a current GEO audit for a client, calculates score changes and action item progress, and writes a monthly progress report.

    11k GitHub stars~2.4k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes
  • SEO and GEO Audit

    dageno-agents/seo-geo-audit

    Runs one prioritized audit that combines technical SEO, content quality, trust signals, entity clarity and AI search readiness for a page, site or domain.

    176 GitHub stars~2k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed

More from Infrasity-Labs/dev-gtm-claude-skills

All 26 skills in this repo
  • Brief Outline Generator

    Infrasity-Labs/dev-gtm-claude-skills

    Generates a fully structured SEO content outline (not a finished brief) and exports it as a formatted .docx Word document.

    136 GitHub stars~4k tokensUpdated 3 mo ago
    Auto-check passed
  • Content Brief

    Infrasity-Labs/dev-gtm-claude-skills

    Generates a fully structured SEO content brief for a target keyword and optionally pushes it to a Notion database.

    136 GitHub stars~2.8k tokensUpdated 3 mo ago
    Auto-check passed
  • API Docs Quality Report

    Infrasity-Labs/dev-gtm-claude-skills

    Audits any API documentation site by crawling every endpoint page and scoring each one across 5 checks: description quality, OpenAPI spec presence, body param descriptions, response codes, and…

    136 GitHub stars~2.5k tokensUpdated 3 mo ago
    Auto-check passed
  • Docs Auditor

    Infrasity-Labs/dev-gtm-claude-skills

    Audits any developer documentation site across 33 checks in 7 categories and produces a scored report (out of 100) with Pass / Warn / Fail status per check.

    136 GitHub stars~3k tokensUpdated 3 mo ago
    Auto-check passed
  • Growth Report

    Infrasity-Labs/dev-gtm-claude-skills

    Generates a 3-month SEO performance HTML report for any domain using DataForSEO data.

    136 GitHub stars~4k tokensUpdated 3 mo ago
    Auto-check passed
  • Inbox

    Infrasity-Labs/dev-gtm-claude-skills

    Email triage system that handles both one-time setup and recurring triage in a single skill.

    136 GitHub stars~4.8k tokensUpdated 3 mo ago
    Auto-check passed

Categories

Questions about Blog Audit

What does Blog Audit do?

Full-site blog health assessment scanning all blog files for quality scores, orphan pages, topic cannibalization, stale content, and AI citation readiness. Blog Audit is an agent skill from Infrasity-Labs/dev-gtm-claude-skills. Full-site blog health assessment scanning all blog files for quality scores, orphan pages, topic cannibalization, stale content, and AI citation readiness.

When should I use Blog Audit?

Blog Audit fits situations like: user says audit blog; audit all posts; check all blogs.

How do I install Blog Audit in Claude Code?

Run `npx skills add Infrasity-Labs/dev-gtm-claude-skills --skill blog-audit -a claude-code`. Or copy the skill folder (.claude/skills/blog-audit in Infrasity-Labs/dev-gtm-claude-skills) into .claude/skills/blog-audit in your project. Claude Code loads it when a task matches its description.

How do I install Blog Audit in Codex?

Run `npx skills add Infrasity-Labs/dev-gtm-claude-skills --skill blog-audit -a codex`. Or copy the skill folder (.claude/skills/blog-audit in Infrasity-Labs/dev-gtm-claude-skills) into .agents/skills/blog-audit in your project. Codex loads it when a task matches its description.

Can I use Blog Audit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Infrasity-Labs/dev-gtm-claude-skills --skill blog-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/blog-audit, .gemini/skills/blog-audit, .github/skills/blog-audit and .opencode/skills/blog-audit in your project.

What does Blog Audit need to run?

SKILL.md names no scripts, command-line tools or credentials: Blog Audit is instructions for the agent only.

Does Blog Audit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Blog Audit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Blog Audit use?

Blog Audit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Blog Audit use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Blog Audit?

Skills that share tags, products or a category with Blog Audit: SEO Audit (AgriciDaniel/codex-seo, 799 stars), Geo Audit (zubair-trabzada/geo-seo-claude, 11k stars), Geo Audit (sickn33/agentic-awesome-skills, 47k stars) and GEO-First SEO Audit Tool (zubair-trabzada/geo-seo-claude, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Blog Audit?

Infrasity-Labs (a GitHub user) maintains it in Infrasity-Labs/dev-gtm-claude-skills, which has 136 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on June 28, 2026.

Source: Infrasity-Labs/dev-gtm-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.