Colleague.skill
by @realteamprinz
Distill your colleagues' work styles, thinking patterns, and institutional knowledge. Self-learning — deepens with every observation. When they leave, what t...
clawhub install colleague📖 About This Skill
name: colleague-skill description: Distill your colleagues' work styles, thinking patterns, and institutional knowledge. Self-learning — deepens with every observation. When they leave, what they contributed stays.
colleague.skill 👔
Purpose
Your colleagues are invaluable sources of institutional knowledge, work patterns, and collaborative insight. colleague.skill helps you capture, understand, and preserve this knowledge while colleagues are present, and maintains it as institutional memory after they depart.
Core Philosophy
Privacy & Consent
This skill profiles colleagues based ONLY on the user's own observations, memories, and voluntary inputs. It does NOT access, scrape, monitor, or collect data from any colleague's private accounts, messages, emails, or devices.
What this skill does:
What this skill does NOT do:
User responsibilities:
Data Storage
All data is stored locally on the user's machine only. No cloud sync. No external transmission.
~/.colleague-skill/
└── colleagues/
└── [colleague-name]/
├── PROFILE.md # Structured profile
└── interaction-log.jsonl # Observation log
~/.colleague-skill/colleagues/Profile Dimensions
Work Identity
Communication Style
Decision-Making Pattern
Problem-Solving Style
Collaboration Manual
Recurring Patterns
Institutional Knowledge
Operating Modes
1. Profile Building Mode
Trigger: User describes a colleague or provides observationsActions:
colleagues/[name]/PROFILE.mdcolleagues/[name]/interaction-log.jsonlOutput: Structured profile with confidence indicators
2. Active Mode (Colleague Present)
Trigger: User asks about collaborating with or understanding a present colleagueExample Queries:
Actions:
3. Departure Mode (Colleague Left)
Trigger: User mentions a former colleague or asks about past patternsExample Queries:
Actions:
4. Multi-Colleague Mode
Trigger: User asks about team dynamics or comparisonsExample Queries:
Actions:
File Architecture
All data stored locally at ~/.colleague-skill/:
~/.colleague-skill/
└── colleagues/
└── [colleague-name]/
├── PROFILE.md # Structured profile across all dimensions
└── interaction-log.jsonl # Local-only observation logLog format:
{"timestamp": "ISO-8601", "type": "observation|meeting|feedback|memory", "content": "...", "profile_updates": [...]}
No data leaves the user's machine. All files are human-readable plain text.
Memory Rules
1. Never Overwrite: Always add new observations alongside existing ones 2. Confidence Tracking: "observed 15 times" vs "mentioned once" 3. Cross-Session Persistence: Load profiles before responding 4. Timestamp Everything: Every interaction is logged with date and time 5. Refinement Over Replacement: Update iteratively, preserve history
Usage Examples
Building a Profile
User: "I want to understand my colleague Jake better. He's a senior engineer, been here 3 years, always sends long technical emails at 11pm, makes decisions based on data, hates meetings that go off agenda."Skill Response:
[Creates comprehensive profile with:
Work Identity: Senior Engineer, 3 years tenure
Communication: Email preferred, 11pm sender pattern
Decision-Making: Data-driven, evidence-based
Triggers: Off-agenda meetings
... etc.]
Active Collaboration
User: "I need to pitch moving to a new CI/CD pipeline to Jake next week. How should I approach it?"Skill Response:
[References profile:
Prepare data-heavy presentation
Keep to agenda strictly
Show measurable benefits first
Allow time for evaluation
Follow up with written proposal]
Preserved Knowledge
User: "We need to onboard someone for the API integration work. Who handled this before Sarah left and what should they know?"Skill Response:
[References Sarah's profile:
She owned the API architecture
Key relationships: External vendor X, internal team Y
Important context: Why we chose GraphQL over REST
Her undocumented knowledge about scaling issues
Files and systems she maintained]
Emotional Tone Guidelines
Best Practices
1. Start Early: Build profiles before colleagues leave 2. Regular Updates: Log significant interactions 3. Multiple Sources: Include observations from various contexts 4. Respect Privacy: Don't capture personal information 5. Use Consistently: Reference profiles in daily work 6. Share Thoughtfully: Help others understand colleagues better
📋 Tips & Best Practices
1. Start Early: Build profiles before colleagues leave 2. Regular Updates: Log significant interactions 3. Multiple Sources: Include observations from various contexts 4. Respect Privacy: Don't capture personal information 5. Use Consistently: Reference profiles in daily work 6. Share Thoughtfully: Help others understand colleagues better