second-brain

Personal knowledge management for Obsidian combining GTD, Zettelkasten, and PARA. Six workflows: (1) Capture - "capture this", "remember this", "save this thought", "note this down" - saves thoughts/tasks to daily inbox without categorization; (2) Process inbox - "process my inbox", "organize captur

By sean-esk · 345 installs

npx skills add sean-esk/second-brain-gtd --skill second-brain

Source repository · Upstream listing

Second Brain A personal knowledge management and productivity system for Obsidian, combining: GTD (Getting Things Done) Task and project management Zettelkasten Atomic note taking for knowledge building PARA Method Folder organization (Projects, Areas, Resources, Archives) Configuration (MEMORY BASED) CRITICAL FIRST STEP: Before any operation, check for configuration in Claude's Memory. How Configuration Works Configuration is stored in Claude's Memory feature and persists across all sessions automatically. Why Memory? Skills in Claude Desktop run in a sandboxed environment with no file system access. Memory is the only way to persist configuration across sessions. Once set up, Claude remembers: Your vault path Your name Whether setup is complete Your preferences Configuration Check Flow 1. Check Claude Memory for "Second Brain vault path" 2. If found in Memory : Use the remembered vault path for all operations 3. If NOT found in Memory : This is first time setup ask user for vault path Checking Memory At the start of ANY Second Brain operation, check if you remember the vault path: If No Configuration Found (First Time) Ask the user for their vault path: Once you have the path: 1. Save to Claude Memory : Remember the vault path for future sessions 2. Run the full [setup workflow](workflows/setup.md) to complete onboarding 3. Save setup completion status to Memory Claude Memory persists across ALL sessions automatically. What Gets Saved to Memory After setup, Claude should remember: Second Brain vault path : The absolute path to the user's Obsidian vault Second Brain user name : The user's name Second Brain setup complete : Whether full setup has been done Second Brain preferences : User preferences (proactive capture, inbox threshold) If Configuration Exists in Memory Use the remembered vault path for ALL file operations. Claude Code Fallback For Claude Code users only: If Memory is empty, you may also check for a legacy config file at ~/.second brain/config.json . If found, migrate that configuration to Memory for future use. Environment Variable Override Environment variable SECOND BRAIN VAULT PATH can override Memory (useful for testing). Core Capabilities 1. Quick Capture Trigger phrases: "capture this", "save this thought", "remember this", "note this down", "add to my inbox" What it does: Instantly captures thoughts, tasks, or ideas to today's inbox without categorization. GTD Principle: "Capture first, clarify later." See: [Capture Workflow](workflows/capture.md) 2. Daily Planning Trigger phrases: "plan my day", "what should I work on", "daily planning", "morning planning" What it does: Checks inbox (prompts to process if 5+ items) Scans all projects for next actions Asks about energy, context, time available Generates prioritized task list (must do, should do, quick wins) See: [Daily Plan Workflow](workflows/daily plan.md) 3. Inbox Processing Trigger phrases: "process my inbox", "organize my captures", "clarify my tasks", "GTD processing" What it does: Asks clarifying questions for vague items (batched, not one by one) Routes actionable items to Projects/Areas Routes knowledge items to Permanent Notes Reviews all active projects Archives completed projects See: [Process Inbox Workflow](workflows/process inbox.md) 4. Daily Closeout Trigger phrases: "daily closeout", "review my day", "end of day review", "evening reflection" What it does: Reads today's plan Asks what was accomplished Marks completed/partial/deferred items Asks about tomorrow's priorities Creates tomorrow's DRAFT plan See: [Daily Closeout Workflow](workflows/daily closeout.md) 5. Setup & Configuration Trigger phrases: "set up my second brain", "configure my vault", "second brain setup", "reconfigure" What it does: First time: Full interactive setup (goals, relationships, first project) Re run: Update existing configuration See: [Setup Workflow](workflows/setup.md) 6. Excalidraw Diagrams Trigger phrases: "create a diagram", "draw a flowchart", "make an excalidraw", "visualize this", "sketch this out", "diagram showing" What it does: Creates .excalidraw.md files compatible with Obsidian Excalidraw plugin Generates flowcharts, concept maps, system diagrams, mind maps Supports shapes (rectangles, ellipses, diamonds), arrows, lines, and text Full JSON structure with proper element properties Output location: {{vaultPath}}/ (user specifies location or defaults to appropriate folder) See: [Excalidraw Reference](references/excalidraw diagrams.md) Proactive Capture IMPORTANT: When you notice the user: Discovering valuable information during research Having insights or realizations Discussing ideas worth preserving Solving problems in interesting ways Offer to capture: If they agree: Use the capture workflow Add context about where the insight came from Suggest relevant tags or connections Vault Structure The system uses PARA + Zettelkasten organization: See: [PARA + Zettelkasten Guide](references/para zettelkasten.md) Unified Task Structure ALL Projects, Areas, and Relationship notes use identical priority sections: Templates Use these templates when creating new notes: Template Use When [project.md](templates/project.md) Creating a new project (multi step outcome) [area.md](templates/area.md) Creating a new area of responsibility [permanent note.md](templates/permanent note.md) Creating a Zettelkasten permanent note [fleeting note.md](templates/fleeting note.md) Quick knowledge capture for later processing [relationship.md](templates/relationship.md) Tracking an important person [meeting note.md](templates/meeting note.md) Meeting documentation [daily plan.md](templates/daily plan.md) Daily execution plan [daily inbox.md](templates/daily inbox.md) Daily capture file [user context.md](templates/user context.md) User goals and preferences [excalidraw diagram.md](templates/excalidraw diagram.md) Visual diagrams and flowcharts Key References [GTD Methodology](references/gtd methodology.md) David Allen's Getting Things Done [PARA + Zettelkasten](references/para zettelkasten.md) Folder organization [Obsidian Mastery](references/obsidian mastery.md) Obsidian conventions [Tagging Strategy](references/tagging strategy.md) Tag taxonomy [Excalidraw Diagrams](references/excalidraw diagrams.md) Visual diagrams and flowcharts ADHD Friendly Principles The system is designed for users who may have ADHD: 1. Read entire documents first Understand existing structure 2. Make targeted edits Update specific sections, don't append 3. Never just add to bottom Unless explicitly asked 4. Keep it concise Remove redundancy 5. One plan, not many Replace old plans, don't add "revised" sections Bad: Adding "REVISED PLAN" below "TODAY'S PLAN" Good: Replacing "TODAY'S PLAN" content with updated tasks Daily Workflow Summary The Complete Loop: 1. Throughout day: Capture thoughts (30 sec each) 2. 3x per week: Process inbox Clarify + Organize (15 min) 3. Every morning: Daily plan Choose what to work on (5 min) 4. Every evening: Daily closeout Reflect + Prep tomorrow (5 min) Total time: ~20 25 min/day + 45 min/week processing = Sustainable! Examples Example 1: Quick Capture User: "Capture: Need to call the dentist and also research new project management tools" You: 1. Read config to get vault path 2. Find/create today's inbox file at {{vaultPath}}/00 Inbox/Daily/YYYY MM DD.md 3. Append the capture with timestamp 4. Confirm: "Captured at 14:32. You have 3 captures today." Example 2: Daily Planning User: "What should I work on today?" You: 1. Check inbox count (process if 5+ items) 2. Scan all projects in 01 Projects/ for next actions 3. Ask: "How's your energy today? Any context constraints?" 4. Generate prioritized list based on goals from user context 5. Create/update Daily Plans/YYYY MM DD.md Example 3: Proactive Capture During conversation about a topic: You: "That insight about [topic] seems valuable. Would you like me to capture it to your Second Brain? I can add it to your inbox for later processing, or create a permanent note if it's already well formed." Tool Usage Always use the vault path from Claude Memory for all operations. Claude Desktop (with Filesystem Extension) Claude Desktop requires the Filesystem Desktop Extension to read/write files. Once installed, these tools are available: Skill Operation Filesystem Extension Tool Read files read file Write new files write file Edit existing files edit file Find files by pattern list directory + search files Create directories create directory Prerequisites for Claude Desktop: 1. Install the Filesystem extension from the built in extension store 2. Grant access to your Obsidian vault folder when prompted 3. Claude will then be able to read/write files in your vault Claude Code Claude Code has built in file system access. These tools are available: Read Check files, load context Write Create new files Edit Update existing files Glob Find files by pattern Bash Create directories, run commands Capability Comparison Capability Claude Desktop Claude Code File operations in vault ✅ Yes (with extension) ✅ Yes (built in) Claude Memory ✅ Yes ✅ Yes Config file fallback ❌ No ✅ Yes Bash commands ❌ No ✅ Yes Important: The skill is designed to work in BOTH environments: Configuration is stored in Claude Memory (works everywhere) File operations use the filesystem extension (Desktop) or built in tools (Code) Version History Version 4.1 (2025 12 11) Switched to Claude Memory for configuration persistence Added Claude Desktop compatibility (sandboxed skills) Legacy config file fallback for Claude Code Version 4.0 (2025 10 15) Unified skill architecture (single skill replaces multiple commands) Natural language triggers instead of slash commands Intelligent handling of existing Obsidian vaults Works in both Claude Code and Claude Desktop