All skills
muratcankoylan avatar

/digital-brain-skill

This skill should be used for personal operating-system workflows: content creation, voice consistency, relationship lookup, meeting preparation, weekly review, goal tracking, personal brand management, and network management.

  • 46 files
  • 125.5 KB
  • Updated 3 months ago
  • GitHub
Use this Skill: https://skilld.dev/gh/muratcankoylan/agent-skills-for-context-engineering/digital-brain-skill

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈62 tokens for metadata: the name and description. ≈1.7k when used: this file. ≈24k more on demand in 30 files.

Description uses 3.0% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈242 characters, or 3.0%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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

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:

  1. Read identity/voice.md → Extract voice attributes
  2. Check identity/brand.md → Confirm "ai_agents" is a content pillar
  3. Reference content/posts.jsonl → Find similar successful posts
  4. Draft post matching voice patterns
  5. Suggest adding to content/ideas.jsonl if 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:

  1. Search network/contacts.jsonl for "Sarah Chen"
  2. Get recent entries from network/interactions.jsonl
  3. Check operations/todos.md for pending items with Sarah
  4. Compile brief: role, context, last discussed, follow-ups

Output: Pre-meeting brief with relationship context.

Guidelines

  1. Voice First: Always read identity/voice.md before any content generation
  2. Append Only: Never delete from JSONL files - archive instead
  3. Update Timestamps: Set updated field when modifying tracked data
  4. Cross-Reference: Knowledge informs content, network informs operations
  5. Log Interactions: Always log meetings/calls to interactions.jsonl
  6. Preserve History: Past content in posts.jsonl informs 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:

External resources:


Skill Metadata

Created: 2024-12-29 Last Updated: 2024-12-29 Author: Murat Can Koylan Version: 1.0.0

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 6 days ago.

updated 3 months ago
version
1.0.0

README badge

README badge for muratcankoylan/agent-skills-for-context-engineering/digital-brain-skill