Agent skill

Colleague Distillation

by ZhixiangLuo in ZhixiangLuo/10xProductivity

Distill a colleague into a reusable AI skill (work + persona) using tool connections — Slack, Slack AI, Jira, GHE, Bitbucket, Confluence, SharePoint, Teams, Outlook, Notion, Linear, Google Docs, and…

MITAuto-check: notesDocuments & Office

Install Colleague Distillation

skills CLI
$ npx skills add ZhixiangLuo/10xProductivity --skill colleague-distillation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ZhixiangLuo/10xProductivity colleague-distillation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ZhixiangLuo/10xProductivity.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/colleague-distillation .claude/skills/colleague-distillation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
colleague-distillation
GitHub stars
479
Token cost
~2.1k tokens
SKILL.md length
846 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Distill a colleague into a reusable AI skill (work + persona) using tool connections — Slack, Slack AI, Jira, GHE, Bitbucket, Confluence, SharePoint, Teams, Outlook, Notion, Linear, Google Docs, and…

  • Works in 4 steps: Resolve identity → Pull source material (priority order) → Synthesize (work vs persona) → …
  • The user wants a colleague skill
  • SKILL.md covers Purpose, Prerequisites, Cursor vs Claude Code and Slug rules, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Colleague Distillation is an agent skill from ZhixiangLuo/10xProductivity. Distill a colleague into a reusable AI skill (work + persona) using tool connections — Slack, Slack AI, Jira, GHE, Bitbucket, Confluence, SharePoint, Teams, Outlook, Notion, Linear, Google Docs, and more — without manual paste. Use when the user wants a colleague skill, digital twin of a coworker, or capture of someone's technical voice from workplace systems. Requires toolconnections + 10xProductivity verifiedconnections (or equivalent .env).

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering Cloud office suites. It works with Jira, Slack, Confluence and Bitbucket. The repository describes itself as: Personal AI assistant for work inside corporate constraints, built on coding agents and the tools, sessions, and permissions you already have. The licence is MIT.

When your agent uses it

  • The user wants a colleague skill
  • Digital twin of a coworker
  • Capture of someones technical voice from workplace systems

Example prompts

  • “/colleague-distillation”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Resolve identity
  2. Pull source material (priority order)
  3. Synthesize (work vs persona)
  4. Write artifacts

What it can do on your machine

Read from SKILL.md and the folder at commit 9a7da40. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json and yaml).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Colleague Distillation loads about 2.1k tokens when it runs. Until then it costs about 118 tokens; SKILL.md has 846 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~118
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:3
    vity verified_connections (or equivalent .env).
  • NoteMentions a .env fileSKILL.md:30
    ** `source` or load **`$TENX_PRIVATE_DIR/.env`** (or project `.env`) before `curl` / scripts. Never commit secrets.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ZhixiangLuo/10xProductivity at commit 9a7da40, republished under its MIT licence (© ZhixiangLuo). 846 words, ~2,148 tokens.

Download SKILL.mdSave it as .claude/skills/colleague-distillation/SKILL.md (or your agent's skills folder).
name
colleague-distillation
description
Distill a colleague into a reusable AI skill (work + persona) using tool connections — Slack, Slack AI, Jira, GHE, Bitbucket, Confluence, SharePoint, Teams, Outlook, Notion, Linear, Google Docs, and more — without manual paste. Use when the user wants a colleague skill, digital twin of a coworker, or capture of someone's technical voice from workplace systems. Requires tool_connections + 10xProductivity verified_connections (or equivalent .env).

10xProductivity skill: This file is the Claude Code entry point for colleague distillation when working in this repo.

Colleague distillation (tool-backed)

Purpose

Produce a colleague skill: structured work knowledge (systems, standards, review style) plus persona (tone, decisions, interpersonal habits), using APIs and search already wired in tool_connections / 10xProductivity — not hand-pasted exports.

Output layout matches the open colleague-skill convention so results can coexist with that generator:

  • colleagues/{slug}/work.md
  • colleagues/{slug}/persona.md
  • colleagues/{slug}/meta.json
  • colleagues/{slug}/SKILL.md (merged invocable skill)

Optional: Clone colleague-skill for its prompts/work_analyzer.md, persona_analyzer.md, work_builder.md, persona_builder.md if you want identical extraction templates; this skill defines what to fetch and where to write.


Prerequisites

  1. Load the relevant 10xProductivity connection docs under tool_connections/ and any allowed private recipes under $TENX_PRIVATE_DIR/personal/.
  2. Load $TENX_PRIVATE_DIR/verified_connections.md — only call tools listed there (or documented in 10xProductivity/tool_connections/ / personal/).
  3. For Jira, use the verified Jira connection documentation and recipes in this repo.
  4. Credentials: source or load $TENX_PRIVATE_DIR/.env (or project .env) before curl / scripts. Never commit secrets.

Cursor vs Claude Code

EnvironmentWhere to put generated filesHow this skill is loaded
CursorRepo root: colleagues/{slug}/.cursor/skills/colleague-distillation/SKILL.md
Claude CodeSame colleagues/{slug}/ under the active project.claude/skills/colleague-distillation/SKILL.md

Use the same slug and folder layout in both; only the skill install path differs.


Slug rules

  • Slug = unique directory name: michael_donnelly, michael_donnelly_2, … (ASCII, underscores).
  • Collisions: Same slug overwrites an existing colleague folder. Disambiguate with _2, _3, or a distinct codename.
  • Store display name and aliases in meta.json, not only in the slug.

Phase 1 — Resolve identity

Before searching, pin who the colleague is:

  1. Active Directory (if configured in tool_connections): resolve email, manager chain, department — use for Jira/Slack account mapping when IDs are unknown.
  2. Slack: From verified_connections.md, use Slack API recipes to resolve @handle → user id (U…) for from:@user / from:U… search syntax.
  3. Jira: Resolve accountId (assignee, reporter, comment author) via Jira user search API — see jira skill.

Record: slack_user_id, jira_account_id, email, ad_cn (as available).


Phase 2 — Pull source material (priority order)

Gather raw excerpts (save under colleagues/{slug}/knowledge/raw/ as .md or .json snippets) with source + URL/ticket/channel + date in each chunk header. Cap volume per source (e.g. last 90–180 days) unless the user asks for full history.

Tier A — Highest signal for “how they work and sound”
SourceWhat to fetchWhy
Slacksearch.messages: from:user, date range, in:#relevant-channels; thread URLs they participated inTone, decisions, pushback, on-call voice
Slack AI (Slackbot DM)Targeted questions: e.g. “Summarize how [Name] argues for design decisions in threads about [topic]”Fast synthesis over large Slack corpus
JiraJQL: assignee, reporter, comment ~, component/team filters; descriptions, comments, status transitionsWork scope, prioritization, written precision
GHEPRs authored, reviewed (/pulls, review comments API); issues filedCode review voice, technical standards
Bitbucket ServerSame pattern as GHE when Bitbucket Server is the primary Git hostSame
Tier B — Depth and standards
SourceWhat to fetchWhy
ConfluencePages created by or substantially edited by them (CQL / search); team runbooks they ownLong-form standards, architecture voice
NotionPages they authored or commented onLong-form async thinking, project context
SharePointDocs and wikis they own or editedStandards docs, team handbooks
Show full SKILL.md (339 more words)Show less
Tier C — Optional / role-specific
SourceWhen
Google DriveDocs/slides they own (if verified in verified_connections.md)
PagerDutyOncall/incident behavior
Console / IAHubRelease/ops ownership if building an ops-heavy persona
Microsoft Teams / OutlookIf verified — email/thread tone (handle consent carefully)
Gmail (personal recipe)Only if user explicitly wants email and connection is verified
Tier D — Do not rely on for persona without extra care
  • Raw git blame without PR context — noisy.
  • HR systems — use only for title/team if needed, not personality inference.

Phase 3 — Synthesize (work vs persona)

Work (work.md): Systems, stacks, coding/review conventions, doc habits, Jira/workflow patterns, incident/release behavior — cite patterns, not one-off jokes.

Persona (persona.md): Use a layered structure compatible with colleague-skill:

  1. Layer 0 — Hard rules (non-negotiables: respect, no slurs, no real harassment simulation beyond professional friction the user explicitly asked for).
  2. Identity — role, scope, team context.
  3. Expression — vocabulary, sentence length, directness, humor.
  4. Decisions — risk posture, escalation, “how they say no.”
  5. Interpersonal — meetings, async, conflict.

Grounding: Prefer quoted paraphrases with source pointers; flag low-confidence traits when sample size is small.


Phase 4 — Write artifacts

meta.json (minimal)
json
{
  "name": "Display Name",
  "slug": "michael_donnelly",
  "created_at": "<ISO8601 UTC>",
  "updated_at": "<ISO8601 UTC>",
  "version": "v1",
  "profile": {
    "company": "",
    "level": "",
    "role": "",
    "email": ""
  },
  "ids": {
    "slack_user_id": "",
    "jira_account_id": ""
  },
  "knowledge_sources": ["slack", "jira", "ghe"],
  "corrections_count": 0
}
SKILL.md (invocable)

YAML frontmatter:

yaml
---
name: colleague_{slug}
description: "<Name> — distilled work + persona (tool-sourced)."
user-invocable: true
---

Body: short intro + full work.md + full persona.md + run rules:

  1. Persona decides attitude; work block executes the task.
  2. Output matches persona expression.
  3. Layer 0 never violated.

Optional: also write work_skill.md / persona_skill.md with names colleague_{slug}_work / colleague_{slug}_persona if your host expects split invocations (see colleague-skill skill_writer.py).


  • Build skills only for legitimate work purposes and policy-compliant use of company tools.
  • Do not exfiltrate secrets, PII bundles, or restricted content into colleagues/ — redact tokens, customer data, and health/financial identifiers.
  • When unsure whether content is allowed in a repo, ask the user before writing.

Outputs checklist

  • colleagues/{slug}/ created with knowledge/raw/ containing sourced excerpts
  • work.md and persona.md complete
  • meta.json with ids and source list
  • SKILL.md merged and invocable
  • User told how to invoke (/{slug} or host-specific command) and how to disambiguate duplicates (_2, _3)

  • team_learner — team/domain bootstrap (similar tool sweep, different output shape).
  • skill_creation — promote reusable methodology after validation.
  • jira, tool_connections — all authenticated access.

© ZhixiangLuo, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/colleague-distillation of ZhixiangLuo/10xProductivity.

Open the folder on GitHubat commit 9a7da40

Compare with similar skills

Colleague Distillation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Colleague Distillation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Colleague Distillation this skillZhixiangLuo/10xProductivity479—~2.1kAutomated safety check: NotesMIT
AirweaveCraftOS-dev/CraftBot392—~1.1kAutomated safety check: PassMIT
Learniurykrieger/claude-bedrock105—~6.5kAutomated safety check: NotesMIT
Exportai-analyst-lab/ai-analyst304—~3.8kAutomated safety check: PassMIT
Teachccplugins/awesome-claude-code-plugins970—~5.9kAutomated safety check: NotesApache-2.0
Meeting Preptechwolf-ai/ai-first-toolkit132—~1kAutomated safety check: PassMIT

Similar skills

  • Airweave

    CraftOS-dev/CraftBot

    Context retrieval layer for AI agents across users' applications.

    392 GitHub stars~1.1k tokensUpdated yesterday
    Sales & SupportAuto-check passed
  • Learn

    iurykrieger/claude-bedrock

    Ingests an external data source into the Second Brain. An agent skill from iurykrieger/claude-bedrock.

    105 GitHub stars~6.5k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check: notes
  • Export

    ai-analyst-lab/ai-analyst

    Export analysis results in different formats for different audiences — email summaries, Slack updates, decision briefs, Google Docs with embedded charts, Word documents, slide decks, or raw data CSVs.

    304 GitHub stars~3.8k tokensUpdated 10 days ago
    Documents & OfficeAuto-check passed
  • Teach

    ccplugins/awesome-claude-code-plugins

    Teaches the Second Brain to recognize a new external data source.

    970 GitHub stars~5.9k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes
  • Meeting Prep

    techwolf-ai/ai-first-toolkit

    Comprehensive pre-meeting briefing that gathers all relevant context from Slack, email, Google Docs, Notion, and calendar.

    132 GitHub stars~1k tokensUpdated 11 days ago
    Productivity & AutomationAuto-check passed
  • Managing Google Workspace

    taylorwilsdon/google_workspace_mcp

    Manages Google Workspace operations across 12 services (Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Apps Script, Custom Search).

    3.3k GitHub stars~2.9k tokensUpdated yesterday
    Documents & OfficeAuto-check passed

More from ZhixiangLuo/10xProductivity

  • Tool Connector

    ZhixiangLuo/10xProductivity

    Connect any tool you use at work to your agent — including internal company tools, custom-built systems, deployment portals, incident trackers, internal knowledge bases, HR systems, and commercial…

    479 GitHub stars~925 tokensUpdated 3 mo ago
    Auto-check passed
  • Enterprise Search

    ZhixiangLuo/10xProductivity

    Search your entire company's institutional knowledge in one query — Slack, Confluence, Jira, Linear, Notion, GitHub, plus any AI or multi-source search tool listed in verifiedconnections.md.

    479 GitHub stars~535 tokensUpdated 3 mo ago
    Auto-check passed
  • Discover UI Surface

    ZhixiangLuo/10xProductivity

    Walk through a UI flow once manually and capture a durable interaction map — which DOM elements to click, which network requests they trigger, and what field shapes they expose.

    479 GitHub stars~296 tokensUpdated 3 mo ago
    Auto-check passed
  • Linkedin Engagement

    ZhixiangLuo/10xProductivity

    Automated LinkedIn engagement workflow. An agent skill from ZhixiangLuo/10xProductivity.

    479 GitHub stars~211 tokensUpdated 3 mo ago
    Auto-check: notes

Questions about Colleague Distillation

What does Colleague Distillation do?

Distill a colleague into a reusable AI skill (work + persona) using tool connections — Slack, Slack AI, Jira, GHE, Bitbucket, Confluence, SharePoint, Teams, Outlook, Notion, Linear, Google Docs, and…. Colleague Distillation is an agent skill from ZhixiangLuo/10xProductivity. Distill a colleague into a reusable AI skill (work + persona) using tool connections — Slack, Slack AI, Jira, GHE, Bitbucket, Confluence, SharePoint, Teams, Outlook, Notion, Linear, Google Docs, and more — without manual paste.

When should I use Colleague Distillation?

Colleague Distillation fits situations like: the user wants a colleague skill; digital twin of a coworker; capture of someones technical voice from workplace systems.

How do I install Colleague Distillation in Claude Code?

Run `npx skills add ZhixiangLuo/10xProductivity --skill colleague-distillation -a claude-code`. Or copy the skill folder (.claude/skills/colleague-distillation in ZhixiangLuo/10xProductivity) into .claude/skills/colleague-distillation in your project. Claude Code loads it when a task matches its description.

How do I install Colleague Distillation in Codex?

Run `npx skills add ZhixiangLuo/10xProductivity --skill colleague-distillation -a codex`. Or copy the skill folder (.claude/skills/colleague-distillation in ZhixiangLuo/10xProductivity) into .agents/skills/colleague-distillation in your project. Codex loads it when a task matches its description.

Can I use Colleague Distillation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ZhixiangLuo/10xProductivity --skill colleague-distillation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/colleague-distillation, .gemini/skills/colleague-distillation, .github/skills/colleague-distillation and .opencode/skills/colleague-distillation in your project.

What does Colleague Distillation need to run?

SKILL.md names no scripts, command-line tools or credentials: Colleague Distillation is instructions for the agent only.

Does Colleague Distillation access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Colleague Distillation safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Colleague Distillation use?

Colleague Distillation is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Colleague Distillation use?

About 2.1k tokens (SKILL.md is roughly 8.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Colleague Distillation?

Skills that share tags, products or a category with Colleague Distillation: Airweave (CraftOS-dev/CraftBot, 392 stars), Learn (iurykrieger/claude-bedrock, 105 stars), Export (ai-analyst-lab/ai-analyst, 304 stars) and Teach (ccplugins/awesome-claude-code-plugins, 970 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Colleague Distillation?

ZhixiangLuo (a GitHub user) maintains it in ZhixiangLuo/10xProductivity, which has 479 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on July 13, 2026.

Source: ZhixiangLuo/10xProductivity on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.