Personal Brain Skill

Personal Brain OS — Claude Code Plugin

A markdown vault personal operating system for research software engineers and startup founders. Identity, voice, knowledge, relationships, and episodic memory — all in plain files, readable by Claude Code and Obsidian alike.

Features

• 6 skill modules — personal-identity, content-pipeline, engineering-knowledge, network, operations-memory, personal-life
• 13 slash commands — /bootstrap, /weekly-review, /meeting-prep, /write-blog, /score-idea, /journal, /life-review, /research-codebase, /create-plan, /implement, /promote, /init-thoughts, /link-brain
• 3 specialist agents — brain-checker, thoughts-locator, promotion-agent
• 5 automation scripts — weekly review, stale contacts, content ideas, idea-to-draft, wellness report
• Safety hooks — append-only entity enforcement, session initialization

Installation

claude --plugin-dir /path/to/personal-brain-skill

Or add to your project's marketplace.json:

{
  "plugins": [
    { "path": "/path/to/personal-brain-skill" }
  ]
}

Quick Start

1. Install the plugin
2. Run /bootstrap to scaffold your ~/brain/ vault
3. Fill in identity/voice.md and identity/values.yaml
4. Start using commands: /journal, /score-idea, /meeting-prep, etc.

Prerequisites

• Claude Code CLI
• python-frontmatter (for automation scripts): pip install python-frontmatter
• git-crypt (optional, for encrypting sensitive files): brew install git-crypt

Architecture

~/brain/          — Your Brain OS vault (persistent, git-versioned)
thoughts/         — Working memory during deep work sessions
.brain/           — Symlink from project repos to ~/brain/ (read-only)

The plugin provides behavioral rules and templates. Personal data lives in ~/brain/.

Commands

Command	Purpose
/bootstrap	Scaffold a new Brain OS vault
/init-thoughts	Initialize a Thoughts working-memory repo
/link-brain	Symlink Brain OS into current project
/weekly-review	Comprehensive weekly review
/meeting-prep	Prepare for a meeting with a contact
/write-blog	Write a blog post with voice compliance
/score-idea	Score a content idea (4 dimensions)
/journal	Create/update daily note with wellness
/life-review	Personal life review with trends
/research-codebase	Research and save to Thoughts
/create-plan	Create implementation plan
/implement	Execute a plan phase by phase
/promote	Promote Thoughts artifacts to Brain OS