mcpField
C
claude-blog-brain

claude-blog-brain

github.com/agricidanielMarketing & growth2.6k204 installsUpdated 2w ago
Repository

About claude-blog-brain

Claude Blog Brain is a vault-based workflow for organizing source material, synthesizing research, and producing reports and visuals. It is intended for blog research, with read-only, evidence-tracking rules and quality checks.

Key features

  1. 01Vault scaffolding and ingestion
  2. 02Research synthesis and reporting
  3. 03Visual generation
  4. 04Vault linting
  5. 05Next-action guidance
  6. 06Source and adapter tracking

Use cases

  1. 01Build a vault for blog research
  2. 02Synthesize collected source material
  3. 03Review vault quality and next steps

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/agricidaniel/claude-blog --skill claude-blog-brain

After installing, type/claude-blog-brainin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
_attachments/
brain-relationship-map.svg
.claude-plugin/
marketplace.json
plugin.json
.github/
CODEOWNERS
dependabot.yml
PULL_REQUEST_TEMPLATE.md
.github/ISSUE_TEMPLATE/
bug_report.yml
config.yml
.github/workflows/
ci.yml
.obsidian/
graph.json
.raw/
.manifest.json
.raw/sources/claude-blog-brain-data/
google-updates.json
.raw/sources/claude-blog-skill/
CHANGELOG.md
CITATION.cff
CLAUDE.md
.raw/sources/claude-blog-skill/.claude-plugin/
plugin.json
.raw/sources/claude-blog-skill/agents/
blog-researcher.md
blog-reviewer.md
blog-seo.md
blog-translator.md
blog-writer.md
.raw/sources/claude-blog-skill/docs/
ARCHITECTURE.md
COMMANDS.md
CONTRIBUTORS.md
DEMO.md
INSTALLATION.md
MCP-INTEGRATION.md
PRIVACY.md
PUBLISHING.md

Details

From the project README

Claude Blog Brain

Operate the vault first. Read CODEX.md, wiki/hot.md, and wiki/index.md before changing notes.

Commands

/claude-blog-brain new <client-slug> --owner <name>
/claude-blog-brain demo
/claude-blog-brain ingest --vault <path> --file <source>
/claude-blog-brain synthesize --vault <path>
/claude-blog-brain report --vault <path>
/claude-blog-brain visuals --vault <path>
/claude-blog-brain lint --vault <path>
/claude-blog-brain next --vault <path>

Source checkout equivalent:

claude-blog-brain new <client-slug> --owner <name>
claude-blog-brain demo
claude-blog-brain ingest --vault <path> --file <source>
claude-blog-brain synthesize --vault <path>
claude-blog-brain report --vault <path> --html-only

Required Operating Rules

  1. Read <vault>/CODEX.md.
  2. Read <vault>/wiki/hot.md.
  3. Read <vault>/wiki/index.md.
  4. Preserve .raw/ as immutable source material.
  5. Never store credentials in the vault.
  6. Never make domain-specific claims without dated trustworthy sources.
  7. Keep hot, index, overview, and log current.
  8. Record research evidence in references/source-ledger.json.
  9. Record domain adapter completion in references/adapter-manifest.json.

Script Mapping

  • new -> python scripts/scaffold_vault.py
  • demo -> python scripts/build_demo_vault.py
  • ingest -> python scripts/ingest_source.py
  • synthesize -> python scripts/synthesize_brain.py
  • report -> python scripts/render_brain_report.py
  • visuals -> python scripts/generate_vault_visuals.py
  • lint -> python scripts/lint_vault.py
  • next -> python scripts/guide_next_action.py

Quality Gates

  • No ranking or traffic guarantee; content outcomes are probabilistic and never certain
  • No credentials, tokens, API keys, or private client content in repo artifacts
  • No mutation of a CMS, GSC, GA4, or publishing platform; the brain is advisory and read-only
  • No recommendation without a dated source, confidence level, and rollback note
  • No deprecated advice (HowTo schema, retired FAQ rich results, FID) presented as current
  • No fabricated or unsourced statistics and no generic, unsupported, or low-quality generated filler presented as fact

Do not call this brain market-ready unless scripts/audit_brain.py --require market-ready passes. A scaffold is not a finished brain.

Research Refresh

monthly for Google algorithm updates and Search Central policy; before every release for E-E-A-T framing, schema deprecations, and GEO/AEO citation claims; on-changelog for the claude-blog skill

Community

Use public project Discussions for questions and support: https://github.com/AgriciDaniel/claude-blog/discussions. Report reproducible defects through public Issues: https://github.com/AgriciDaniel/claude-blog/issues.

Comments

Markdown supported