digital-brain
Scannednpx machina-cli add skill Sdkwork-Cloud/skills-repository/digital-brain-skill --openclawDigital Brain
A structured personal operating system for managing digital presence, knowledge, relationships, and goals with AI assistance. Designed for founders building in public, content creators growing their audience, and tech-savvy professionals seeking AI-assisted personal management.
Important: This skill uses progressive disclosure. Module-specific instructions are in each subdirectory's .md file. Only load what's needed for the current task.
When to Activate
Activate this skill when the user:
- Requests content creation (posts, threads, newsletters) - load identity/voice.md first
- Asks for help with personal brand or positioning
- Needs to look up or manage contacts/relationships
- Wants to capture or develop content ideas
- Requests meeting preparation or follow-up
- Asks for weekly reviews or goal tracking
- Needs to save or retrieve bookmarked resources
- Wants to organize research or learning materials
Trigger phrases: "write a post", "my voice", "content ideas", "who is [name]", "prepare for meeting", "weekly review", "save this", "my goals"
Core Concepts
Progressive Disclosure Architecture
The Digital Brain follows a three-level loading pattern:
| Level | When Loaded | Content |
|---|---|---|
| L1: Metadata | Always | This SKILL.md overview |
| L2: Module Instructions | On-demand | [module]/[MODULE].md files |
| L3: Data Files | As-needed | .jsonl, .yaml, .md data |
File Format Strategy
Formats chosen for optimal agent parsing:
- JSONL (
.jsonl): Append-only logs - ideas, posts, contacts, interactions - YAML (
.yaml): Structured configs - goals, values, circles - Markdown (
.md): Narrative content - voice, brand, calendar, todos - XML (
.xml): Complex prompts - content generation templates
Append-Only Data Integrity
JSONL files are append-only. Never delete entries:
- Mark as
"status": "archived"instead of deleting - Preserves history for pattern analysis
- Enables "what worked" retrospectives
Detailed Topics
Module Overview
digital-brain/
├── identity/ → Voice, brand, values (READ FIRST for content)
├── content/ → Ideas, drafts, posts, calendar
├── knowledge/ → Bookmarks, research, learning
├── network/ → Contacts, interactions, intros
├── operations/ → Todos, goals, meetings, metrics
└── agents/ → Automation scripts
Identity Module (Critical for Content)
Always read identity/voice.md before generating any content.
Contains:
voice.md- Tone, style, vocabulary, patternsbrand.md- Positioning, audience, content pillarsvalues.yaml- Core beliefs and principlesbio-variants.md- Platform-specific biosprompts/- Reusable generation templates
Content Module
Pipeline: ideas.jsonl → drafts/ → posts.jsonl
- Capture ideas immediately to
ideas.jsonl - Develop in
drafts/usingtemplates/ - Log published content to
posts.jsonlwith metrics - Plan in
calendar.md
Network Module
Personal CRM with relationship tiers:
inner- Weekly touchpointsactive- Bi-weekly touchpointsnetwork- Monthly touchpointsdormant- Quarterly reactivation checks
Operations Module
Productivity system with priority levels:
- P0: Do today, blocking
- P1: This week, important
- P2: This month, valuable
- P3: Backlog, nice to have
Practical Guidance
Content Creation Workflow
1. Read identity/voice.md (REQUIRED)
2. Check identity/brand.md for topic alignment
3. Reference content/posts.jsonl for successful patterns
4. Use content/templates/ as starting structure
5. Draft matching voice attributes
6. Log to posts.jsonl after publishing
Pre-Meeting Preparation
1. Look up contact: network/contacts.jsonl
2. Get history: network/interactions.jsonl
3. Check pending: operations/todos.md
4. Generate brief with context
Weekly Review Process
1. Run: python agents/scripts/weekly_review.py
2. Review metrics in operations/metrics.jsonl
3. Check stale contacts: agents/scripts/stale_contacts.py
4. Update goals progress in operations/goals.yaml
5. Plan next week in content/calendar.md
Examples
Example: Writing an X Post
Input: "Help me write a post about AI agents"
Process:
- Read
identity/voice.md→ Extract voice attributes - Check
identity/brand.md→ Confirm "ai_agents" is a content pillar - Reference
content/posts.jsonl→ Find similar successful posts - Draft post matching voice patterns
- Suggest adding to
content/ideas.jsonlif not publishing immediately
Output: Post draft in user's authentic voice with platform-appropriate format.
Example: Contact Lookup
Input: "Prepare me for my call with Sarah Chen"
Process:
- Search
network/contacts.jsonlfor "Sarah Chen" - Get recent entries from
network/interactions.jsonl - Check
operations/todos.mdfor pending items with Sarah - Compile brief: role, context, last discussed, follow-ups
Output: Pre-meeting brief with relationship context.
Guidelines
- Voice First: Always read
identity/voice.mdbefore any content generation - Append Only: Never delete from JSONL files - archive instead
- Update Timestamps: Set
updatedfield when modifying tracked data - Cross-Reference: Knowledge informs content, network informs operations
- Log Interactions: Always log meetings/calls to
interactions.jsonl - Preserve History: Past content in
posts.jsonlinforms future performance
Integration
This skill integrates context engineering principles:
- context-fundamentals - Progressive disclosure, attention budget management
- memory-systems - JSONL for persistent memory, structured recall
- tool-design - Scripts in
agents/scripts/follow tool design principles - context-optimization - Module separation prevents context bloat
References
Internal references:
- Identity Module - Voice and brand details
- Content Module - Content pipeline docs
- Network Module - CRM documentation
- Operations Module - Productivity system
- Agent Scripts - Automation documentation
External resources:
Skill Metadata
Created: 2024-12-29 Last Updated: 2024-12-29 Author: Murat Can Koylan Version: 1.0.0
Source
git clone https://github.com/Sdkwork-Cloud/skills-repository/blob/main/packages/Agent-Skills-for-Context-Engineering/examples/digital-brain-skill/SKILL.mdView on GitHub Overview
Digital Brain is a structured personal operating system for managing your digital presence, knowledge, relationships, and goals with AI assistance. It’s designed for founders building in public, content creators growing their audience, and tech-savvy professionals seeking AI-enhanced personal management. It uses progressive disclosure to load modules only when needed.
How This Skill Works
The system loads in three levels: L1 metadata always available, L2 module instructions loaded on-demand from module/[MODULE].md, and L3 data files (.jsonl, .yaml, .md) as-needed. It relies on an append-only data model with formats like JSONL for logs, YAML for configs, Markdown for narratives, and XML for templates. Core modules—identity, content, knowledge, network, operations, and agents—organize your voice, posts, bookmarks, contacts, tasks, and automation; identity must be read (identity/voice.md) before generating content.
When to Use It
- Requests content creation (posts, threads, newsletters) and needs identity guidance first
- Needs help with personal brand, positioning, or topic alignment
- Wants to look up or manage contacts/relationships in a structured CRM
- Wants to capture or develop content ideas and plan drafts
- Needs meeting preparation, weekly reviews, goal tracking, or resource bookmarking
Quick Start
- Step 1: Read identity/voice.md (REQUIRED) and identity/brand.md to align voice and positioning
- Step 2: Capture ideas to ideas.jsonl and draft in drafts/ using templates
- Step 3: Publish to posts.jsonl with metrics and plan next steps in calendar.md
Best Practices
- Always load identity/voice.md before generating any content
- Reference identity/brand.md to ensure topic alignment with your positioning
- Follow the ideas.jsonl → drafts/ → posts.jsonl workflow and log posts with metrics
- Use content/templates/ to maintain consistent voice and structure
- Maintain append-only data integrity: archive instead of deleting and use calendar.md for scheduling
Example Use Cases
- A founder writes a LinkedIn post using identity/voice.md for consistent tone and posts.jsonl for publishing data
- A content creator tracks weekly goals in operations and logs published content with engagement metrics
- A marketer looks up a contact in network, drafts outreach in drafts/ and schedules follow-ups
- A researcher saves bookmarks in knowledge and organizes learning materials with calendar-driven planning
- A team uses meeting prep and follow-up tasks via calendar.md and templates for consistent agendas