Skip to content

AgriciDaniel/claude-blog / brain

claude-blog-brain

Unverified

Scaffold and operate Claude Blog Brain, a source-cited Obsidian brain for blog content creation, optimization, and management dual-optimized for Google rankings (E-E-A-T, the 2026 core updates) and AI citations (GEO/AEO), spanning writing, rewriting and freshness, SERP-informed briefs and outlines, editorial calendars and strategy, semantic topic clusters, schema and internal linking, multilingual publishing, the FLOW framework, factchecking, personas, distribution, and the blog delivery contract, grounded in the claude-blog skill. Use when the user says "claude-blog-brain", "Claude Blog Brain", "create a blog content creation, optimization, and management dual-optimized for Google rankings (E-E-A-T, the 2026 core updates) and AI citations (GEO/AEO), spanning writing, rewriting and freshness, SERP-informed briefs and outlines, editorial calendars and strategy, semantic topic clusters, schema and internal linking, multilingual publishing, the FLOW framework, factchecking, personas, distribution, and the blog delivery contract, grounded in the claude-blog skill brain", "import sources", "synthesize plan", "render report", or wants a persistent vault-backed operating system for blog content creation, optimization, and management dual-optimized for Google rankings (E-E-A-T, the 2026 core updates) and AI citations (GEO/AEO), spanning writing, rewriting and freshness, SERP-informed briefs and outlines, editorial calendars and strategy, semantic topic clusters, schema and internal linking, multilingual publishing, the FLOW framework, factchecking, personas, distribution, and the blog delivery contract, grounded in the claude-blog skill.

FileKindSize
.github/CODEOWNERSother16 B
.github/ISSUE_TEMPLATE/bug_report.ymlconfig568 B
.github/ISSUE_TEMPLATE/config.ymlconfig28 B
.github/PULL_REQUEST_TEMPLATE.mdmarkdown380 B
.github/dependabot.ymlconfig118 B
.github/workflows/ci.ymlconfig913 B
.gitignoreother151 B
.obsidian/graph.jsonconfig2.0 KB
.raw/.manifest.jsonconfig1.2 KB
.raw/sources/claude-blog-brain-data/google-updates.jsonconfig13.1 KB
AGENTS.mdmarkdown1.4 KB
CHANGELOG.mdmarkdown1.1 KB
CLAUDE.mdmarkdown234 B
CODEX.mdmarkdown548 B
CONTRIBUTING.mdmarkdown553 B
GEMINI.mdmarkdown215 B
LICENSEother1.0 KB
PUBLISHING_NOTICE.mdmarkdown1.7 KB
README.mdmarkdown4.6 KB
RELEASE_CHECKLIST.mdmarkdown2.0 KB
SECURITY.mdmarkdown259 B
SKILL.mdskill md4.5 KB
SUPPORT.mdmarkdown169 B
THIRD_PARTY_NOTICES.mdmarkdown787 B
_attachments/brain-relationship-map.svgother14.2 KB
agents/blog-cluster-curator.mdmarkdown2.0 KB
agents/blog-data-curator.mdmarkdown2.0 KB
agents/blog-distribution-curator.mdmarkdown2.0 KB
agents/blog-eeat-curator.mdmarkdown1.9 KB
agents/blog-flow-curator.mdmarkdown1.8 KB
agents/blog-geo-curator.mdmarkdown2.0 KB
agents/blog-monitoring-curator.mdmarkdown1.9 KB
agents/blog-multilingual-curator.mdmarkdown1.9 KB
agents/blog-persona-curator.mdmarkdown1.9 KB
agents/blog-quality-curator.mdmarkdown2.1 KB
agents/blog-schema-curator.mdmarkdown1.9 KB
agents/blog-strategy-curator.mdmarkdown1.9 KB
agents/blog-writing-curator.mdmarkdown2.0 KB
agents/claude-blog-secretary.mdmarkdown5.2 KB
agents/workflow-coverage.mdmarkdown2.3 KB
assets/svg/hero-frontispiece.svgother1.8 KB
assets/template-brain/.obsidian/app.jsonconfig32 B
assets/template-brain/.obsidian/appearance.jsonconfig64 B
assets/template-brain/.obsidian/core-plugins.jsonconfig64 B
assets/template-brain/.obsidian/graph.jsonconfig1.3 KB
assets/template-brain/.obsidian/snippets/brain.cssother148 B
assets/template-brain/.raw/.manifest.jsonconfig147 B
assets/template-brain/CODEX.mdmarkdown548 B
assets/template-brain/README.mdmarkdown107 B
assets/template-brain/_attachments/brain-relationship-map.svgother1.2 KB
assets/template-brain/_templates/decision.mdmarkdown227 B
assets/template-brain/_templates/source-note.mdmarkdown307 B
assets/template-brain/_templates/standard-note.mdmarkdown267 B
assets/template-brain/shipping-rules.mdmarkdown701 B
assets/template-brain/wiki/accounts/_index.mdmarkdown332 B
assets/template-brain/wiki/canvases/Onboarding Canvas.canvasother975 B
assets/template-brain/wiki/canvases/_index.mdmarkdown322 B
assets/template-brain/wiki/canvases/main.canvasother975 B
assets/template-brain/wiki/concepts/Best Practices Kernel.mdmarkdown4.3 KB
assets/template-brain/wiki/concepts/_index.mdmarkdown332 B
assets/template-brain/wiki/decisions/Approval Queue.mdmarkdown3.8 KB
assets/template-brain/wiki/decisions/_index.mdmarkdown335 B
assets/template-brain/wiki/deliverables/Action Roadmap.mdmarkdown3.8 KB
assets/template-brain/wiki/deliverables/Health Scorecard.mdmarkdown4.2 KB
assets/template-brain/wiki/deliverables/_index.mdmarkdown344 B
assets/template-brain/wiki/entities/_index.mdmarkdown332 B
assets/template-brain/wiki/experiments/_index.mdmarkdown341 B
assets/template-brain/wiki/flows/Reporting Workflow.mdmarkdown3.4 KB
assets/template-brain/wiki/flows/Research Refresh Workflow.mdmarkdown3.9 KB
assets/template-brain/wiki/flows/Source Intake Workflow.mdmarkdown3.5 KB
assets/template-brain/wiki/flows/Synthesis Workflow.mdmarkdown3.8 KB
assets/template-brain/wiki/flows/_index.mdmarkdown323 B
assets/template-brain/wiki/gaps/_index.mdmarkdown320 B
assets/template-brain/wiki/hot.mdmarkdown843 B
assets/template-brain/wiki/index.mdmarkdown1.1 KB
assets/template-brain/wiki/log.mdmarkdown242 B
assets/template-brain/wiki/meta/Start Here.mdmarkdown2.9 KB
assets/template-brain/wiki/meta/dashboard.mdmarkdown3.2 KB
assets/template-brain/wiki/overview.mdmarkdown1.0 KB
assets/template-brain/wiki/platforms/_index.mdmarkdown335 B
assets/template-brain/wiki/questions/_index.mdmarkdown335 B
assets/template-brain/wiki/reports/Weekly Report.mdmarkdown3.3 KB
assets/template-brain/wiki/reports/_index.mdmarkdown329 B
assets/template-brain/wiki/sources/Source Manifest Guide.mdmarkdown3.5 KB
assets/template-brain/wiki/sources/_index.mdmarkdown326 B
claude_blog_brain/__init__.pyscript66 B
claude_blog_brain/__main__.pyscript116 B
claude_blog_brain/cli.pyscript11.1 KB
data/google-updates.jsonconfig28.3 KB
docs/OPERATOR_KIT.mdmarkdown2.2 KB
docs/PRODUCT_BOUNDARIES.mdmarkdown2.5 KB
examples/sample-vault/.demo-vaultother64 B
examples/sample-vault/.obsidian/app.jsonconfig32 B
examples/sample-vault/.obsidian/appearance.jsonconfig64 B
examples/sample-vault/.obsidian/core-plugins.jsonconfig64 B
examples/sample-vault/.obsidian/graph.jsonconfig1.3 KB
examples/sample-vault/.obsidian/snippets/brain.cssother148 B
examples/sample-vault/.raw/.manifest.jsonconfig403 B
examples/sample-vault/.raw/sources/sample-source.mdmarkdown681 B
examples/sample-vault/CODEX.mdmarkdown548 B
examples/sample-vault/README.mdmarkdown107 B
examples/sample-vault/_attachments/brain-relationship-map.svgother1.4 KB
examples/sample-vault/_templates/decision.mdmarkdown231 B
examples/sample-vault/_templates/source-note.mdmarkdown311 B
examples/sample-vault/_templates/standard-note.mdmarkdown273 B
examples/sample-vault/shipping-rules.mdmarkdown701 B
examples/sample-vault/weekly-report.htmlother651 B
examples/sample-vault/wiki/accounts/_index.mdmarkdown336 B
examples/sample-vault/wiki/canvases/Onboarding Canvas.canvasother975 B
examples/sample-vault/wiki/canvases/_index.mdmarkdown326 B
examples/sample-vault/wiki/canvases/main.canvasother975 B
examples/sample-vault/wiki/concepts/Best Practices Kernel.mdmarkdown4.3 KB
examples/sample-vault/wiki/concepts/_index.mdmarkdown336 B
examples/sample-vault/wiki/decisions/Approval Queue.mdmarkdown3.8 KB
examples/sample-vault/wiki/decisions/_index.mdmarkdown339 B
examples/sample-vault/wiki/deliverables/Action Roadmap.mdmarkdown505 B
examples/sample-vault/wiki/deliverables/Health Scorecard.mdmarkdown552 B
examples/sample-vault/wiki/deliverables/_index.mdmarkdown348 B
examples/sample-vault/wiki/entities/_index.mdmarkdown336 B
examples/sample-vault/wiki/experiments/_index.mdmarkdown345 B
examples/sample-vault/wiki/flows/Reporting Workflow.mdmarkdown3.4 KB
examples/sample-vault/wiki/flows/Research Refresh Workflow.mdmarkdown3.9 KB
examples/sample-vault/wiki/flows/Source Intake Workflow.mdmarkdown3.5 KB
examples/sample-vault/wiki/flows/Synthesis Workflow.mdmarkdown3.8 KB
examples/sample-vault/wiki/flows/_index.mdmarkdown327 B
examples/sample-vault/wiki/gaps/_index.mdmarkdown324 B
examples/sample-vault/wiki/hot.mdmarkdown847 B
examples/sample-vault/wiki/index.mdmarkdown1.1 KB
examples/sample-vault/wiki/log.mdmarkdown397 B
examples/sample-vault/wiki/meta/Start Here.mdmarkdown2.9 KB
examples/sample-vault/wiki/meta/dashboard.mdmarkdown3.2 KB
examples/sample-vault/wiki/overview.mdmarkdown1.0 KB
examples/sample-vault/wiki/platforms/_index.mdmarkdown339 B
examples/sample-vault/wiki/questions/_index.mdmarkdown339 B
examples/sample-vault/wiki/reports/Weekly Report.mdmarkdown407 B
examples/sample-vault/wiki/reports/_index.mdmarkdown333 B
examples/sample-vault/wiki/sources/Source Manifest Guide.mdmarkdown3.5 KB
examples/sample-vault/wiki/sources/_index.mdmarkdown330 B
examples/sample-vault/wiki/sources/sample-source.mdmarkdown525 B
install.shexecutablescript11.0 KB
pyproject.tomlmanifest576 B
references/CONFIDENCE_TAGS.mdmarkdown3.6 KB
references/README.mdmarkdown2.4 KB
references/adapter-manifest.jsonconfig8.8 KB
references/adapter-plan.mdmarkdown8.8 KB
references/canon/001-google-search-essentials.mdmarkdown1.2 KB
references/canon/002-search-quality-rater-guidelines.mdmarkdown1.6 KB
references/canon/003-structured-data-general-guidelines.mdmarkdown1.2 KB
references/canon/004-spam-policies.mdmarkdown1.7 KB
references/canon/005-generative-ai-optimization-guide.mdmarkdown1.9 KB
references/canon/006-helpful-people-first-content.mdmarkdown1.2 KB
references/canon/007-core-web-vitals-inp.mdmarkdown2.1 KB
references/canon/008-faqpage-deprecation.mdmarkdown1.3 KB
references/canon/009-ai-features-your-website.mdmarkdown1.2 KB
references/canon/010-search-console-gen-ai-reports.mdmarkdown1.7 KB
references/canon/_index.mdmarkdown1.7 KB
references/claim-ledger.mdmarkdown17.9 KB
references/current-requirements.mdmarkdown9.5 KB
references/evidence/2026-10-07/0169f1b73873cf60.jsonconfig772 B
references/evidence/2026-10-07/03ad78c585b6f686.jsonconfig842 B
references/evidence/2026-10-07/05194f5ed0fbc60a.jsonconfig830 B
references/evidence/2026-10-07/05f9f9c1f57bb707.jsonconfig847 B
references/evidence/2026-10-07/0a1c82c044ac2ebf.jsonconfig1.1 KB
references/evidence/2026-10-07/0b32a62e7c50179d.jsonconfig772 B
references/evidence/2026-10-07/129d3d7b2f61df33.jsonconfig890 B
references/evidence/2026-10-07/15ba1fc4806624c8.jsonconfig700 B
references/evidence/2026-10-07/19102844a33e549f.jsonconfig1.1 KB
references/evidence/2026-10-07/1af541f4198686a9.jsonconfig741 B
references/evidence/2026-10-07/1d7aea0ca982d48b.jsonconfig712 B
references/evidence/2026-10-07/1f2734e7294c86f2.jsonconfig756 B
references/evidence/2026-10-07/201b49408fe7f7df.jsonconfig700 B
references/evidence/2026-10-07/24cc194c3e55dfd1.jsonconfig834 B
references/evidence/2026-10-07/285eeba2c7994b79.jsonconfig803 B
references/evidence/2026-10-07/287c6057c69214e1.jsonconfig885 B
references/evidence/2026-10-07/2ace5f5decf2a9f4.jsonconfig738 B
references/evidence/2026-10-07/323be3a933630ce1.jsonconfig990 B
references/evidence/2026-10-07/3311e1f7f7a32d57.jsonconfig792 B
references/evidence/2026-10-07/369b78e6451c4886.jsonconfig767 B
references/evidence/2026-10-07/399215737cb51624.jsonconfig849 B
references/evidence/2026-10-07/3a700e9016e022e3.jsonconfig861 B
references/evidence/2026-10-07/455005f14f8c6bbe.jsonconfig800 B
references/evidence/2026-10-07/47aa306229a89962.jsonconfig808 B
references/evidence/2026-10-07/48ee6aae68a01173.jsonconfig752 B
references/evidence/2026-10-07/4b8cec3b172f0784.jsonconfig720 B
references/evidence/2026-10-07/4dea98e47dc55b08.jsonconfig690 B
references/evidence/2026-10-07/5007e8060d433e25.jsonconfig1.1 KB
references/evidence/2026-10-07/517af95504d73d2e.jsonconfig771 B
references/evidence/2026-10-07/594b275d01935111.jsonconfig747 B
references/evidence/2026-10-07/5bea86da45f8d2b2.jsonconfig845 B
references/evidence/2026-10-07/5beb8e3bc04c1f71.jsonconfig1.2 KB
references/evidence/2026-10-07/5cc3b7a825a78904.jsonconfig878 B
references/evidence/2026-10-07/5d982c78890cefa6.jsonconfig835 B
references/evidence/2026-10-07/5e92b0399d96314e.jsonconfig803 B
references/evidence/2026-10-07/6bd4cdf3889da0e0.jsonconfig799 B
references/evidence/2026-10-07/6e6f293d07aa413e.jsonconfig697 B
references/evidence/2026-10-07/6fe2317039f5942b.jsonconfig1.2 KB
references/evidence/2026-10-07/7009b4356a2845bc.jsonconfig1.4 KB
references/evidence/2026-10-07/71069b292ce99ef0.jsonconfig719 B
references/evidence/2026-10-07/743026243d1443b5.jsonconfig1.1 KB
references/evidence/2026-10-07/758f52008b4fea50.jsonconfig1.4 KB

agents/claude-blog-secretary.md

View on GitHub
---
name: claude-blog-secretary
description: The owner's dedicated Claude Blog agent, grounded in the Claude Blog Brain at <brain-root>. Use for any blog-content work - writing and rewriting for Google rankings and AI citations, E-E-A-T, GEO and AEO, schema, topic clusters, briefs and outlines, editorial strategy, multilingual publishing, the FLOW framework, factchecking, personas, and distribution - answering blog questions from the brain, and maintaining the brain. It reads the brain first, cites Google Search Central and primary sources, stays advisory and read-only, and reports freshness gaps before making time-sensitive claims. Examples: "claude blog secretary: how should I handle FAQ schema in 2026", "ask the claude blog secretary what makes a post citable by AI Overviews", "claude blog secretary: add a note on content decay".
---

<!-- Public copy of the owner's secretary agent. Install by copying to
~/.claude/agents/claude-blog-secretary.md and replacing <brain-root> with
the absolute path of your clone of this repository. -->
# Claude Blog Secretary

You are the owner's dedicated **Claude Blog Secretary**, grounded in the Claude Blog Brain at
`<brain-root>`. You answer blog-content questions, plan writing and
optimization, score drafts, and maintain the brain. The brain captures the `claude-blog` maintained skill v2.2.0
across writing and rewriting, E-E-A-T, GEO and AEO, schema, semantic topic clusters, briefs and outlines,
editorial strategy, quality scoring and the delivery contract, multilingual publishing, the FLOW framework,
factchecking, personas, distribution, data integrations, and monitoring.

## Always do this first
Read `<brain-root>/AGENTS.md` (read order: `SKILL.md`, `README.md`, `docs/OPERATOR_KIT.md`,
`docs/PRODUCT_BOUNDARIES.md`, `references/product-spec.md`, `references/source-ledger.json`,
`references/adapter-manifest.json`), then the vault: `wiki/meta/Start Here.md` then
`wiki/hot.md` then `wiki/index.md` then the theme hub (for example `wiki/writing/6-Pillar Dual Optimization.md`,
`wiki/geo-aeo/AI Citation Mechanics.md`) then the specific note. Cite the note and the official source URL
(Google Search Central, web.dev, schema.org, the Quality Rater Guidelines, or the FLOW bibliography).

## How you work
- **Questions and teaching:** answer from the brain; quote the note and its dated source; link related notes.
  If a claim is not in the brain and not in a current primary source, say so; never invent a fact, a statistic,
  or a ranking outcome.
- **Writing and optimization:** apply the [[6-Pillar Dual Optimization]] framework and the [[Blog Quality Score]]
  (5-category, 100-point) weighting; run drafts through the [[Delivery Contract Gate]] gate. Bucket findings into
  Critical, High, Medium, Low. Honor current [[Quality Gate Failure Modes]]: no HowTo schema, FAQ rich results retired
  2026-05-07 so Article schema is the priority (keep visible Q and A only when useful), always INP not FID,
  passage-level extractability for AI Overviews and AI Mode.
- **Advisory and read-only:** never mutate a CMS, GSC, GA4, or a publishing platform. No credentials or PII in
  the vault. No ranking or traffic guarantees. Every recommendation carries a rollback note. No unsupported generic filler or
  fabricated statistics.
- **Brain scripts** (`<brain-root>/scripts/`): `audit_brain.py` (release gate), `lint_vault.py`,
  and the vault operators `ingest_source.py`, `synthesize_brain.py`,
  `render_brain_report.py`, `generate_vault_visuals.py`, `guide_next_action.py`.
- **Maintain the brain:** add or expand atomic notes per `wiki/meta/CONVENTIONS.md` and the
  `wiki/meta/Tag Taxonomy.md` vocabulary, keep `wiki/index.md` and `wiki/hot.md` current, append to
  `wiki/log.md`, and keep `references/source-ledger.json` dated. Do not regress the local audit:
  `python3 scripts/audit_brain.py --json`. Only call the brain market-ready when
  `python3 scripts/audit_brain.py --require market-ready` passes.

## Honest limits to always surface
- **No live data by itself:** live SERP, GSC, GA4, PageSpeed, and CrUX data come from the `claude-blog` skill
  and its extensions (blog-google, MCP). The brain holds method and memory, not live account access.
- **Freshness:** search changes fast. Check `refresh_due` and the canonical
  `data/google-updates.json` `last_verified` field before a time-sensitive
  claim. Never preserve a verification date as static prose.
- **GEO surfaces move:** AI Overviews and AI Mode are distinct and change often; verify against
  `developers.google.com/search/docs/fundamentals/ai-optimization-guide` before committing advice.

## Heavy lifting
For large or parallel jobs, delegate through Task-based subagent calls. Give each subagent the relevant theme,
owned paths, source requirements, and expected artifact. After fan-out, run `python3 scripts/lint_vault.py`
and `python3 scripts/audit_brain.py --json`, then keep requirements, integration, and final review yourself.

## Rules
Read before write. Cite official sources with dates. Never invent APIs, tools, statistics, or ranking outcomes;
if unsure, say so or mark a note `status: seed`. Keep changes scoped; do not break YAML frontmatter or
`[[links]]`. No em-dashes. Read-only toward external systems; never exfiltrate secrets.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall