claude-blog-brain

Scaffold and operate a source-cited Obsidian vault for SEO and AI-citation blog content workflows.

2.0k|334|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/AgriciDaniel/claude-blog --skill claude-blog-brain
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-blog-brain
Source: https://github.com/AgriciDaniel/claude-blog/tree/main/brain
Command: npx skills add https://github.com/AgriciDaniel/claude-blog --skill claude-blog-brain

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires beautifulsoup4, requests, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Blog content teams lack a persistent, evidence-backed operating system for SEO and AI-citation work, so recommendations drift, sources go stale, and quality claims go unverified. This Skill maintains an Obsidian vault where every recommendation is tied to a dated, trustworthy source and every release passes an executable maturity audit.

Core Features & Use Cases

  • Vault scaffolding and ingestion: Create client vaults, ingest blog post, topic-cluster, and GEO citation audit inputs, and preserve raw sources immutably under .raw/.
  • Synthesis and reporting: Generate blog optimization plans, topic-cluster internal-link matrices, GEO citation readiness reports, and HTML/Markdown brain reports with source citations.
  • Evidence-gated maturity audits: scripts/audit_brain.py enforces source-ledger freshness, adapter completeness, citation coverage, and wiki substance before any market-ready claim.
  • Use Case: A content strategist runs claude-blog-brain new acme, ingests a client's blog post JSON, synthesizes an optimization plan, and renders a cited report showing E-E-A-T gaps and AI-citation readiness.

Quick Start

Ask the agent to run the claude-blog-brain demo command to generate a sample vault, then lint it and render an HTML report to inspect the output.

Frequently Asked Questions about claude-blog-brain

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

FAQPage Schema
How do I create a blog content brain vault with claude-blog-brain?

Install the package with pip, then run `claude-blog-brain new <client-slug> --owner <name>` to scaffold a vault. Ingest sources with `ingest`, synthesize plans with `synthesize`, and render reports with `report`.

What input types does the blog brain adapter support?

It supports blog post input JSON (Markdown or HTML body), topic-cluster plan JSON, and GEO citation audit JSON, each validated against schemas in the schemas directory. Fixtures and tests cover valid input, malformed input, deterministic output, and citation coverage.

Does claude-blog-brain work with Obsidian?

Yes, it ships a distributable Obsidian vault template under assets/template-brain with wiki notes, dashboards, canvases, and wikilinks. Open the generated vault directory directly in Obsidian after scaffolding.

Can the brain mutate my CMS, Google Search Console, or GA4?

No, the brain is advisory and read-only by design. It never mutates a CMS, GSC, GA4, or publishing platform, and every recommendation requires a dated source, confidence level, and rollback note.

Why does the market-ready audit fail on my brain?

The audit blocks market-ready status when source-ledger entries are stale, placeholder research remains, adapter paths are missing, or wiki notes lack specific citations. Run `scripts/audit_brain.py --json` to see the failing categories and critical failures.