1---
2name: digital-brain
3description: This skill should be used when the user asks to "write a post", "check my voice", "look up contact", "prepare for meeting", "weekly review", "track goals", or mentions personal brand, content creation, network management, or voice consistency.
4version: 1.0.0
5---
6 
7# Digital Brain
8 
9A 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.
10 
11**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.
12 
13## When to Activate
14 
15Activate this skill when the user:
16 
17- Requests content creation (posts, threads, newsletters) - load identity/voice.md first
18- Asks for help with personal brand or positioning
19- Needs to look up or manage contacts/relationships
20- Wants to capture or develop content ideas
21- Requests meeting preparation or follow-up
22- Asks for weekly reviews or goal tracking
23- Needs to save or retrieve bookmarked resources
24- Wants to organize research or learning materials
25 
26**Trigger phrases**: "write a post", "my voice", "content ideas", "who is [name]", "prepare for meeting", "weekly review", "save this", "my goals"
27 
28## Core Concepts
29 
30### Progressive Disclosure Architecture
31 
32The Digital Brain follows a three-level loading pattern:
33 
34| Level | When Loaded | Content |
35|-------|-------------|---------|
36| **L1: Metadata** | Always | This SKILL.md overview |
37| **L2: Module Instructions** | On-demand | `[module]/[MODULE].md` files |
38| **L3: Data Files** | As-needed | `.jsonl`, `.yaml`, `.md` data |
39 
40### File Format Strategy
41 
42Formats chosen for optimal agent parsing:
43 
44- **JSONL** (`.jsonl`): Append-only logs - ideas, posts, contacts, interactions
45- **YAML** (`.yaml`): Structured configs - goals, values, circles
46- **Markdown** (`.md`): Narrative content - voice, brand, calendar, todos
47- **XML** (`.xml`): Complex prompts - content generation templates
48 
49### Append-Only Data Integrity
50 
51JSONL files are **append-only**. Never delete entries:
52- Mark as `"status": "archived"` instead of deleting
53- Preserves history for pattern analysis
54- Enables "what worked" retrospectives
55 
56## Detailed Topics
57 
58### Module Overview
59 
60```
61digital-brain/
62├── identity/     → Voice, brand, values (READ FIRST for content)
63├── content/      → Ideas, drafts, posts, calendar
64├── knowledge/    → Bookmarks, research, learning
65├── network/      → Contacts, interactions, intros
66├── operations/   → Todos, goals, meetings, metrics
67└── agents/       → Automation scripts
68```
69 
70### Identity Module (Critical for Content)
71 
72**Always read `identity/voice.md` before generating any content.**
73 
74Contains:
75- `voice.md` - Tone, style, vocabulary, patterns
76- `brand.md` - Positioning, audience, content pillars
77- `values.yaml` - Core beliefs and principles
78- `bio-variants.md` - Platform-specific bios
79- `prompts/` - Reusable generation templates
80 
81### Content Module
82 
83Pipeline: `ideas.jsonl` → `drafts/` → `posts.jsonl`
84 
85- Capture ideas immediately to `ideas.jsonl`
86- Develop in `drafts/` using `templates/`
87- Log published content to `posts.jsonl` with metrics
88- Plan in `calendar.md`
89 
90### Network Module
91 
92Personal CRM with relationship tiers:
93- `inner` - Weekly touchpoints
94- `active` - Bi-weekly touchpoints
95- `network` - Monthly touchpoints
96- `dormant` - Quarterly reactivation checks
97 
98### Operations Module
99 
100Productivity system with priority levels:
101- P0: Do today, blocking
102- P1: This week, important
103- P2: This month, valuable
104- P3: Backlog, nice to have
105 
106## Practical Guidance
107 
108### Content Creation Workflow
109 
110```
1111. Read identity/voice.md (REQUIRED)
1122. Check identity/brand.md for topic alignment
1133. Reference content/posts.jsonl for successful patterns
1144. Use content/templates/ as starting structure
1155. Draft matching voice attributes
1166. Log to posts.jsonl after publishing
117```
118 
119### Pre-Meeting Preparation
120 
121```
1221. Look up contact: network/contacts.jsonl
1232. Get history: network/interactions.jsonl
1243. Check pending: operations/todos.md
1254. Generate brief with context
126```
127 
128### Weekly Review Process
129 
130```
1311. Run: python agents/scripts/weekly_review.py
1322. Review metrics in operations/metrics.jsonl
1333. Check stale contacts: agents/scripts/stale_contacts.py
1344. Update goals progress in operations/goals.yaml
1355. Plan next week in content/calendar.md
136```
137 
138## Examples
139 
140### Example: Writing an X Post
141 
142**Input**: "Help me write a post about AI agents"
143 
144**Process**:
1451. Read `identity/voice.md` → Extract voice attributes
1462. Check `identity/brand.md` → Confirm "ai_agents" is a content pillar
1473. Reference `content/posts.jsonl` → Find similar successful posts
1484. Draft post matching voice patterns
1495. Suggest adding to `content/ideas.jsonl` if not publishing immediately
150 
151**Output**: Post draft in user's authentic voice with platform-appropriate format.
152 
153### Example: Contact Lookup
154 
155**Input**: "Prepare me for my call with Sarah Chen"
156 
157**Process**:
1581. Search `network/contacts.jsonl` for "Sarah Chen"
1592. Get recent entries from `network/interactions.jsonl`
1603. Check `operations/todos.md` for pending items with Sarah
1614. Compile brief: role, context, last discussed, follow-ups
162 
163**Output**: Pre-meeting brief with relationship context.
164 
165## Guidelines
166 
1671. **Voice First**: Always read `identity/voice.md` before any content generation
1682. **Append Only**: Never delete from JSONL files - archive instead
1693. **Update Timestamps**: Set `updated` field when modifying tracked data
1704. **Cross-Reference**: Knowledge informs content, network informs operations
1715. **Log Interactions**: Always log meetings/calls to `interactions.jsonl`
1726. **Preserve History**: Past content in `posts.jsonl` informs future performance
173 
174## Integration
175 
176This skill integrates context engineering principles:
177 
178- **context-fundamentals** - Progressive disclosure, attention budget management
179- **memory-systems** - JSONL for persistent memory, structured recall
180- **tool-design** - Scripts in `agents/scripts/` follow tool design principles
181- **context-optimization** - Module separation prevents context bloat
182 
183## References
184 
185Internal references:
186- [Identity Module](./identity/IDENTITY.md) - Voice and brand details
187- [Content Module](./content/CONTENT.md) - Content pipeline docs
188- [Network Module](./network/NETWORK.md) - CRM documentation
189- [Operations Module](./operations/OPERATIONS.md) - Productivity system
190- [Agent Scripts](./agents/AGENTS.md) - Automation documentation
191 
192External resources:
193- [Agent Skills for Context Engineering](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering)
194- [Anthropic Context Engineering Guide](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents)
195 
196---
197 
198## Skill Metadata
199 
200**Created**: 2024-12-29
201**Last Updated**: 2024-12-29
202**Author**: Murat Can Koylan
203**Version**: 1.0.0
204