digital-brain

Files (47)

• .gitignore
• AGENT.md
• HOW-SKILLS-BUILT-THIS.md
• README.md
• SKILL.md
• SKILLS-MAPPING.md
• AGENTS.md · agents/
• content_ideas.py · agents/scripts/
• idea_to_draft.py · agents/scripts/
• stale_contacts.py · agents/scripts/
• weekly_review.py · agents/scripts/
• CONTENT.md · content/
• calendar.md · content/
• engagement.jsonl · content/
• ideas.jsonl · content/
• posts.jsonl · content/
• linkedin-post.md · content/templates/
• newsletter.md · content/templates/
• thread.md · content/templates/
• content-workflow.md · examples/
• meeting-prep.md · examples/
• IDENTITY.md · identity/
• bio-variants.md · identity/
• brand.md · identity/
• content-generation.xml · identity/prompts/
• reply-generator.xml · identity/prompts/
• values.yaml · identity/
• voice.md · identity/
• KNOWLEDGE.md · knowledge/
• bookmarks.jsonl · knowledge/
• competitors.md · knowledge/
• learning.yaml · knowledge/
• _template.md · knowledge/research/
• NETWORK.md · network/
• circles.yaml · network/
• contacts.jsonl · network/
• interactions.jsonl · network/
• intros.md · network/
• OPERATIONS.md · operations/
• goals.yaml · operations/
• meetings.jsonl · operations/
• metrics.jsonl · operations/
• _weekly_template.md · operations/reviews/
• todos.md · operations/
• package.json
• file-formats.md · references/
• install.sh · scripts/

SKILL.md (first lines)

# Digital 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, patterns
- `brand.md` - Positioning, audience, content pillars
- `values.yaml` - Core beliefs and principles
- `bio-variants.md` - Platform-specific bios
- `prompts/` - Reusable generation templates

### Content Module

Pipeline: `ideas.jsonl` → `drafts/` → `posts.jsonl`

- Capture ideas immediately to `ideas.jsonl`
- Develop in `drafts/` using `templates/`
- Log published content to `posts.jsonl` with metrics
- Plan in `calendar.md`

### Network Module

Personal CRM with relationship tiers:
- `inner` - Weekly touchpoints
- `active` - Bi-weekly touchpoints
- `network` - Monthly touchpoints
- `dormant` - 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

From muratcankoylan/Agent-Skills-for-Context-Engineering, MIT.

More from muratcankoylan/Agent-Skills-for-Context-Engineering