colleague-skill-creator

---
name: colleague-skill-creator
description: Generate AI skills that replicate departed colleagues — their technical style, communication patterns, and domain knowledge — from chat logs, docs, and descriptions.
triggers:
  - create a colleague skill
  - generate a colleague persona
  - recreate my coworker as an AI
  - build a skill from chat logs
  - my teammate left and I need to replace them
  - create colleague from feishu messages
  - make an AI version of my coworker
  - colleague skill from documentation
---

# colleague-skill — AI Colleague Skill Generator

> Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection.

Turn departed colleagues into working AI Skills. Feed in chat logs, docs, emails, or screenshots — get back a Skill that writes code in their style, answers questions in their voice, and knows when they'd deflect blame.

## What It Does

`colleague-skill` is an [AgentSkills](https://agentskills.io)-compatible skill that:

1. **Ingests raw materials** — Feishu/Lark messages, DingTalk docs, emails, PDFs, screenshots, Markdown, or plain text
2. **Extracts two layers** per colleague:
   - **Work Skill** (`work.md`) — tech standards, system knowledge, workflows, domain expertise
   - **Persona** (`persona.md`) — 5-layer personality: hard rules → identity → expression style → decision patterns → interpersonal behavior
3. **Outputs a callable Skill** (`/{slug}`) that runs: `task → Persona judges attitude → Work Skill executes → output in their voice`
4. **Evolves** — append new files, correct via conversation, roll back versions

---

## Installation

### Claude Code (recommended)

```bash
# Project-local (run from git repo root)
mkdir -p .claude/skills
git clone https://github.com/titanwings/colleague-skill .claude/skills/create-colleague

# OR global (available in all projects)
git clone https://github.com/titanwings/colleague-skill ~/.claude/skills/create-colleague

OpenClaw

git clone https://github.com/titanwings/colleague-skill \
  ~/.openclaw/workspace/skills/create-colleague

Python dependencies (optional — needed for auto-collection)

cd .claude/skills/create-colleague
pip install -r requirements.txt

---

Configuration

Auto-collection from Feishu/DingTalk requires credentials. Set these environment variables:

# Feishu / Lark auto-collection
export FEISHU_APP_ID="cli_xxxxxxxxxxxxxxxx"
export FEISHU_APP_SECRET="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# DingTalk auto-collection
export DINGTALK_APP_KEY="dingxxxxxxxxxxxxxxxx"
export DINGTALK_APP_SECRET="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Feishu note: The App bot must be added to the relevant group chats before collection works.

---

Basic Usage

Create a colleague skill

In Claude Code:

/create-colleague

The interactive intake flow will prompt for:

Field	Example	Required?
Name / slug	zhang-wei	Yes
Company + level + role	字节 2-1 后端工程师	Optional
Personality tags	INTJ, 甩锅高手, 字节范	Optional
Data source	Feishu auto / file upload / paste	Optional

All fields can be skipped — description alone is enough to generate a basic skill.

Call a generated skill

/zhang-wei                  # Full skill (Persona + Work)
/zhang-wei-work             # Work capability only
/zhang-wei-persona          # Personality only

Management commands

/list-colleagues                        # List all generated colleague skills
/colleague-rollback zhang-wei v3        # Roll back to version 3
/delete-colleague zhang-wei             # Delete skill

---

Data Sources

Source	How to provide
Feishu messages + docs	Input colleague name → fully automatic via API
DingTalk docs/wiki	Automatic via API; messages require browser fallback
PDF documents	Upload file path
Images / screenshots	Upload file path (OCR + vision extraction)
Feishu JSON export	Upload file path
Email .eml / .mbox	Upload file path
Markdown files	Upload file path
Plain text / paste	Type or paste directly

Quality tip: Prioritize materials the colleague wrote themselves — long-form docs > decision replies > casual messages.

---

Python Tool Usage

You can also drive the tools directly from Python:

Feishu auto-collection

import asyncio
from tools.feishu_auto_collector import FeishuAutoCollector

async def collect():
    collector = FeishuAutoCollector(
        app_id=os.environ["FEISHU_APP_ID"],
        app_secret=os.environ["FEISHU_APP_SECRET"],
    )
    # Collect all messages + docs involving "张伟"
    data = await collector.collect_colleague(name="张伟", days_back=180)
    print(f"Collected {len(data['messages'])} messages, {len(data['docs'])} docs")
    return data

asyncio.run(collect())

Email parsing

from tools.email_parser import EmailParser

parser = EmailParser()

# Parse a single .eml file
result = parser.parse_file("handover.eml")
print(result["body"])

# Parse an entire mbox
results = parser.parse_mbox("archive.mbox", sender_filter="zhang.wei@company.com")
for msg in results:
    print(msg["subject"], msg["date"])

Skill file management

from tools.skill_writer import SkillWriter

writer = SkillWriter(base_dir=".claude/skills")

# Write a new colleague skill
writer.write_skill(
    slug="zhang-wei",
    work_content="# Zhang Wei — Work Skill\n\n...",
    persona_content="# Zhang Wei — Persona\n\n...",
)

# Append new material (incremental merge, preserves existing conclusions)
writer.append_material(
    slug="zhang-wei",
    new_content="New chat logs from Q2...",
    source_type="feishu_messages",
)

# Apply a correction from conversation
writer.apply_correction(
    slug="zhang-wei",
    correction="He would never approve PRs without running tests himself — he's not lazy about that",
)

Version management

from tools.version_manager import VersionManager

vm = VersionManager(base_dir=".claude/skills")

# List versions for a colleague
versions = vm.list_versions("zhang-wei")
for v in versions:
    print(f"{v['version']} — {v['created_at']} — {v['note']}")

# Roll back
vm.rollback("zhang-wei", version="v2")

---

Generated Skill Structure

Each colleague generates two files under colleagues/{slug}/:

colleagues/zhang-wei/
├── zhang-wei.md            # Master skill entry point
├── zhang-wei-work.md       # Work Skill: tech standards, systems, workflows
├── zhang-wei-persona.md    # Persona: 5-layer personality model
├── versions/               # Auto-archived snapshots
│   ├── v1/
│   ├── v2/
│   └── v3/
└── corrections.md          # Conversation-based corrections layer

Persona 5-layer model

Layer 1 — Hard Rules      : Non-negotiable behaviors ("never approves without tests")
Layer 2 — Identity        : Role, seniority, company culture embedding
Layer 3 — Expression      : Vocabulary, sentence length, emoji use, response latency
Layer 4 — Decision Model  : How they prioritize, what triggers caution vs. action
Layer 5 — Interpersonal   : Who they defer to, who they push back on, blame patterns

---

Supported Tags

Personality: 认真负责 · 甩锅高手 · 完美主义 · 差不多就行 · 拖延症 · PUA高手 · 阴阳怪气 · 话少 · 只读不回 · 反复横跳 · 向上管理专家 · 职场政治玩家

Company culture: 字节范 · 阿里味 · 腾讯味 · 华为味 · 百度味 · 美团味 · 第一性原理 · OKR狂热者 · 大厂流水线 · 创业公司派

Seniority levels:

• ByteDance: 2-1 through 3-3+
• Alibaba: P5 through P11
• Tencent: T1 through T4
• Baidu: T5 through T9
• Meituan: P4 through P8
• Huawei: Level 13 through 21

---

Example Interaction

Input when creating: 字节 2-1 后端工程师, INTJ, 甩锅高手, 字节范

Code review scenario:

User       ❯ 帮我看一下这个接口设计

zhang-wei  ❯ 等等，这个接口的 impact 是什么？背景没说清楚。
             （看完后）N+1 查询，改掉。返回结构用统一的
             {code, message, data}，这是规范，不用问为什么。

Blame deflection scenario:

User       ❯ 这个 bug 是你引入的吧

zhang-wei  ❯ 上线时间对上了吗？那个需求改了好几个地方，还有其他变更。

---

Incremental Updates

Colleague skills improve over time without losing existing conclusions:

# In Claude Code — just say:
"给张伟追加这份文档"
# → append_material() runs, merger.md prompt merges incrementally

# Correct behavior mid-conversation:
"他不会这样，他其实很在意代码质量"
# → correction_handler.md writes to corrections.md, effective immediately

---

Project Layout

create-colleague/
├── SKILL.md                          # Skill entry (AgentSkills frontmatter)
├── prompts/
│   ├── intake.md                     # Conversational info intake
│   ├── work_analyzer.md              # Work capability extraction
│   ├── persona_analyzer.md           # Personality extraction + tag translation
│   ├── work_builder.md               # work.md generation template
│   ├── persona_builder.md            # 5-layer persona generation template
│   ├── merger.md                     # Incremental merge logic
│   └── correction_handler.md         # Conversation correction processing
├── tools/
│   ├── feishu_auto_collector.py      # Feishu full-auto collection
│   ├── feishu_browser.py             # Feishu browser fallback
│   ├── feishu_mcp_client.py          # Feishu MCP approach
│   ├── dingtalk_auto_collector.py    # DingTalk collection
│   ├── email_parser.py               # .eml / .mbox parsing
│   ├── skill_writer.py               # Skill file management
│   └── version_manager.py            # Version archive + rollback
├── colleagues/                        # Generated skills (gitignored)
├── requirements.txt
└── LICENSE

---

Troubleshooting

Feishu collection returns empty:

• Confirm FEISHU_APP_ID and FEISHU_APP_SECRET are set
• Ensure the bot has been added to the target group chats
• Try the browser fallback: feishu_browser.py

Skill output sounds generic, not like the person:

• Raw material quality drives output quality — add longer documents they wrote
• Prioritize: long-form writing > decision-type replies > casual chat
• Add correction: "他不是这样的，他更倾向于..."

/create-colleague command not found:

• Verify you cloned into .claude/skills/create-colleague (the directory name matters)
• Run from the git repo root, not a subdirectory
• For global install, confirm ~/.claude/skills/create-colleague/SKILL.md exists

Version rollback fails:

• List available versions first: vm.list_versions("slug")
• Versions are only created on write operations — a brand-new skill has only v1