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

install.sh

View on GitHub
#!/usr/bin/env bash
set -euo pipefail

usage() {
  cat <<'USAGE'
Usage: ./install.sh [--target codex|claude|agents|gemini|openclaw|portable|custom|all] [--path DIR]

Installs the Claude Blog Brain skill surface.
Use --target custom --path <agent-skill-root> for Hermes or another runtime
when its official skill root is known.
Set CLAUDE_BLOG_BRAIN_INSTALL_HOME to test against a temporary home directory.
USAGE
}

target="codex"
custom_path=""
while [ "$#" -gt 0 ]; do
  case "$1" in
    --target) target="${2:?}"; shift 2 ;;
    --path) custom_path="${2:?}"; shift 2 ;;
    -h|--help) usage; exit 0 ;;
    *) echo "ERROR: unknown argument: $1" >&2; usage >&2; exit 2 ;;
  esac
done

case "${target}" in codex|claude|agents|gemini|openclaw|portable|custom|all) ;; *) echo "ERROR: invalid target" >&2; exit 2 ;; esac
if [ "${target}" = "custom" ] && [ -z "${custom_path}" ]; then
  echo "ERROR: --target custom requires --path" >&2
  exit 2
fi

source_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
base_home="${CLAUDE_BLOG_BRAIN_INSTALL_HOME:-${HOME}}"

target_dir() {
  case "$1" in
    codex) echo "${base_home}/.codex/skills/claude-blog-brain" ;;
    claude) echo "${base_home}/.claude/skills/claude-blog-brain" ;;
    agents) echo "${base_home}/.agents/skills/claude-blog-brain" ;;
    openclaw) echo "${base_home}/.openclaw/skills/claude-blog-brain" ;;
    portable) echo "${base_home}/.agent-skills/claude-blog-brain" ;;
    custom) echo "${custom_path%/}/claude-blog-brain" ;;
  esac
}

install_action() {
  local mode="$1" dest="$2"
  python3 - "${mode}" "${source_dir}" "${dest}" <<'PY'
from __future__ import annotations

import hashlib
import json
import os
import shutil
import sys
import tempfile
import uuid
from pathlib import Path, PurePosixPath

MODE, SOURCE_RAW, DEST_RAW = sys.argv[1:]
SOURCE = Path(SOURCE_RAW)
DEST = Path(DEST_RAW)
MARKER = ".claude-blog-brain-install.json"
OWNER = "claude-blog-brain-installer"
TOP_FILES = (
    "SKILL.md", "AGENTS.md", "CLAUDE.md", "GEMINI.md", "README.md",
    "LICENSE", "CHANGELOG.md", "RELEASE_CHECKLIST.md",
)
TREES = ("scripts", "assets/template-brain", "references", "docs")


def fail(message: str) -> None:
    raise SystemExit(f"ERROR: {message}")


def sha256(path: Path) -> str:
    value = hashlib.sha256()
    with path.open("rb") as handle:
        for chunk in iter(lambda: handle.read(1024 * 1024), b""):
            value.update(chunk)
    return value.hexdigest()


def safe_relative(value: object) -> str:
    if not isinstance(value, str):
        fail("installation manifest contains a non-string path")
    path = PurePosixPath(value)
    if not value or path.is_absolute() or ".." in path.parts or value == MARKER:
        fail(f"installation manifest contains an unsafe path: {value!r}")
    return value


def source_files() -> dict[str, Path]:
    result: dict[str, Path] = {}
    for name in TOP_FILES:
        path = SOURCE / name
        if path.is_file():
            result[name] = path
    for tree in TREES:
        root = SOURCE / tree
        for path in sorted(root.rglob("*")):
            if path.is_symlink():
                fail(f"source installation tree contains a symlink: {path}")
            if not path.is_file() or "__pycache__" in path.parts or path.suffix == ".pyc":
                continue
            result[path.relative_to(SOURCE).as_posix()] = path
    return result


def load_owned_manifest() -> dict[str, str] | None:
    if not DEST.exists() and not DEST.is_symlink():
        return None
    if DEST.is_symlink() or not DEST.is_dir():
        fail(f"installation target is not a real directory: {DEST}")
    marker = DEST / MARKER
    if marker.is_symlink() or not marker.is_file():
        fail(f"refusing to overwrite unmarked installation target: {DEST}")
    try:
        data = json.loads(marker.read_text(encoding="utf-8"))
    except (OSError, ValueError) as exc:
        fail(f"invalid installation ownership metadata at {marker}: {exc}")
    if data.get("schema_version") != 1 or data.get("owner") != OWNER:
        fail(f"unrecognized installation ownership metadata at {marker}")
    files = data.get("managed_files")
    if not isinstance(files, dict) or not files:
        fail(f"installation ownership metadata has no managed files: {marker}")
    normalized: dict[str, str] = {}
    for raw_path, raw_hash in files.items():
        rel = safe_relative(raw_path)
        if not isinstance(raw_hash, str) or len(raw_hash) != 64:
            fail(f"installation manifest has an invalid hash for {rel}")
        normalized[rel] = raw_hash
    return normalized


def target_path(rel: str) -> Path:
    path = DEST / Path(*PurePosixPath(rel).parts)
    current = DEST
    for part in PurePosixPath(rel).parts[:-1]:
        current = current / part
        if current.is_symlink():
            fail(f"managed path traverses a symlink: {current}")
        if current.exists() and not current.is_dir():
            fail(f"managed path parent is not a directory: {current}")
    return path


def validate_existing(previous: dict[str, str] | None, incoming: dict[str, Path]) -> None:
    if previous is None:
        return
    for rel, expected in previous.items():
        path = target_path(rel)
        if path.is_symlink() or not path.is_file():
            fail(f"managed installation file is missing or replaced: {path}")
        if sha256(path) != expected:
            fail(f"managed installation file was modified: {path}")
    for rel in incoming:
        path = target_path(rel)
        if rel not in previous and (path.exists() or path.is_symlink()):
            fail(f"incoming managed file would overwrite a user file: {path}")


def remove_managed(root: Path, managed: dict[str, str]) -> None:
    for rel in sorted(managed, key=lambda value: len(PurePosixPath(value).parts), reverse=True):
        path = root / Path(*PurePosixPath(rel).parts)
        if path.exists() or path.is_symlink():
            path.unlink()
    directories: set[Path] = set()
    for rel in managed:
        directory = (root / Path(*PurePosixPath(rel).parts)).parent
        while directory != root and directory.is_relative_to(root):
            directories.add(directory)
            directory = directory.parent
    for directory in sorted(directories, key=lambda value: len(value.parts), reverse=True):
        if directory != root:
            try:
                directory.rmdir()
            except OSError:
                pass


def install(previous: dict[str, str] | None, incoming: dict[str, Path]) -> None:
    DEST.parent.mkdir(parents=True, exist_ok=True)
    temporary = Path(tempfile.mkdtemp(prefix=f".{DEST.name}.install-", dir=DEST.parent))
    temporary.rmdir()
    backup = DEST.parent / f".{DEST.name}.backup-{uuid.uuid4().hex}"
    try:
        if previous is None:
            temporary.mkdir(mode=0o700)
        else:
            shutil.copytree(DEST, temporary, symlinks=True)
            remove_managed(temporary, previous)
        managed_hashes: dict[str, str] = {}
        for rel, source in incoming.items():
            target = temporary / Path(*PurePosixPath(rel).parts)
            if target.exists() or target.is_symlink():
                fail(f"incoming managed file would overwrite a preserved user file: {target}")
            target.parent.mkdir(parents=True, exist_ok=True)
            shutil.copy2(source, target)
            target.chmod(source.stat().st_mode & 0o700)
            managed_hashes[rel] = sha256(target)
        marker = temporary / MARKER
        marker.write_text(json.dumps({
            "schema_version": 1,
            "owner": OWNER,
            "managed_files": dict(sorted(managed_hashes.items())),
        }, indent=2, sort_keys=True) + "\n", encoding="utf-8")
        marker.chmod(0o600)
        if previous is not None:
            os.replace(DEST, backup)
        try:
            os.replace(temporary, DEST)
        except BaseException:
            if previous is not None and backup.exists() and not DEST.exists():
                os.replace(backup, DEST)
            raise
        if backup.exists():
            shutil.rmtree(backup)
    finally:
        if temporary.exists():
            shutil.rmtree(temporary)


incoming = source_files()
if not incoming:
    fail("source installation surface is empty")
previous = load_owned_manifest()
validate_existing(previous, incoming)
if MODE == "apply":
    install(previous, incoming)
elif MODE != "preflight":
    fail(f"unknown installer mode: {MODE}")
PY
}

install_one() {
  local dest="$1"
  install_action apply "${dest}"
  echo "Claude Blog Brain installed to ${dest}"
}

loader_action() {
  local mode="$1" loader="$2"
  python3 - "${mode}" "${loader}" <<'PY'
from __future__ import annotations

import os
import stat
import sys
import tempfile
from pathlib import Path

mode, loader_raw = sys.argv[1:]
loader = Path(loader_raw)
start = b"<!-- claude-blog-brain-install:start -->"
end = b"<!-- claude-blog-brain-install:end -->"
block = start + b"\n@./claude-blog-brain/GEMINI.md\n" + end


def fail(message: str) -> None:
    raise SystemExit(f"ERROR: {message}")


def atomic_write(data: bytes) -> None:
    loader.parent.mkdir(parents=True, exist_ok=True)
    mode = stat.S_IMODE(loader.stat().st_mode) if loader.exists() else 0o600
    descriptor, temporary_raw = tempfile.mkstemp(prefix=f".{loader.name}.", dir=loader.parent)
    temporary = Path(temporary_raw)
    try:
        with os.fdopen(descriptor, "wb") as handle:
            handle.write(data)
        temporary.chmod(mode)
        os.replace(temporary, loader)
    finally:
        if temporary.exists():
            temporary.unlink()


exists = loader.exists() or loader.is_symlink()
if exists and (loader.is_symlink() or not loader.is_file()):
    fail(f"Gemini loader is not a regular file: {loader}")
data = loader.read_bytes() if exists else b""
start_count = data.count(start)
end_count = data.count(end)
block_count = data.count(block)
if start_count or end_count:
    if start_count != 1 or end_count != 1 or block_count != 1:
        fail(f"Gemini loader has malformed, duplicate, or modified ownership markers: {loader}")

if mode == "apply" and block_count == 0:
    atomic_write(data + block)
elif mode not in {"apply", "preflight"}:
    fail(f"unknown Gemini loader mode: {mode}")
PY
}

install_gemini() {
  local dest="${base_home}/.gemini/claude-blog-brain"
  local loader="${base_home}/.gemini/GEMINI.md"
  install_one "${dest}"
  loader_action apply "${loader}"
  echo "Claude Blog Brain Gemini loader updated at ${loader}"
}

if [ "${target}" = "all" ]; then
  for name in codex claude agents openclaw portable; do
    install_action preflight "$(target_dir "${name}")"
  done
  install_action preflight "${base_home}/.gemini/claude-blog-brain"
  loader_action preflight "${base_home}/.gemini/GEMINI.md"
  for name in codex claude agents openclaw portable; do
    install_one "$(target_dir "${name}")"
  done
  install_gemini
elif [ "${target}" = "gemini" ]; then
  install_action preflight "${base_home}/.gemini/claude-blog-brain"
  loader_action preflight "${base_home}/.gemini/GEMINI.md"
  install_gemini
else
  install_action preflight "$(target_dir "${target}")"
  install_one "$(target_dir "${target}")"
fi
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