distilly
"Set up the owner profile so a personal agent knows who it works for (first-run setup, \"get to know me\"), or distill colleague, relationship, or celebrity source material into reusable Person Profiles for agents."
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/titanwings-distilly)HTML
<a href="/listings/titanwings-distilly"><img src="/api/listings/titanwings-distilly/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
π€ For Agents
Open any supported local Agent host and send:
> Install Distilly from `https://github.com/titanwings/distilly`, then verify that this host can discover it.
The Agent installs Distilly as a Skill named `distilly` in the correct host directory.
π€ For Humans
Clone Distilly into the Skills directory used by your host:
git clone https://github.com/titanwings/distilly <DISTILLY_SKILL_DIR>
Host paths, migration, Windows, generated-profile installation, and credential setup are in the **[Install Guide](INSTALL_EN.md)**.
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md Β· Manifest Β· 41 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: distilly
- description: "Set up the owner profile so a personal agent knows who it works for (first-run setup, \"get to know me\"), or distill colleague, relationship, or celebrity source material into reusable Person Profiles for agents."
- argument-hint: "[character] [name-or-slug]"
- version: "1.0.0"
- user-invocable: true
- allowed-tools: Read, Write, Edit, Bash
- ---
- > **Language**: These instructions are written in English. Detect the user's language from their first message and reply to the user in that language throughout.
- > **Skill Root**: Before reading a bundled prompt or running a bundled script, resolve the absolute directory of the `SKILL.md` that the host actually loaded. In the instructions below, `{distilly_skill_root}` means that exact directory. Claude Code exposes it as `${CLAUDE_SKILL_DIR}`; on every other host, use the loaded-skill path supplied by that host's discovery context. Do not assume the shell's current working directory is the Skill root, and do not guess or hard-code an install path. If the host does not expose the loaded path or more than one Distilly installation is ambiguous, ask the user to identify the active installation before running code.
- >
- > Keep the shell in the user's current workspace so relative output paths such as `./skills/...` remain project-local. Resolve every `tools/...` and `prompts/...` resource against `{distilly_skill_root}`. For example, run `tools/owner_profile.py` as `python3 "{distilly_skill_root}/tools/owner_profile.py"`; replace the placeholder with the resolved absolute path in the actual tool call.
- # Distilly Creator
- > Distilly was formerly **Colleague Skill / colleague-skill**. The current Skill frontmatter name and creator entrypoint are both `distilly`.
- ## Route the request
- Read only the flow file the request needs, then follow it.
- | The user says | Flow |
- |---------------|------|
- | "Set up my profile" / "Get to know me" / "Who am I to you", "distill myself", or a host's first run with no owner profile yet | `prompts/flows/owner.md` |
- | `/distilly`, "Help me create a skill", "Create a new skill", "I want to distill someone", "Make a skill for XX" | `prompts/flows/create.md` (its Step 0 sends `owner` back to the owner flow) |
- | "I have new files" / "append", "That's wrong" / "He wouldn't do that" / "He should be", `/update-skill {character} {slug}`, or the alias `/update-colleague {slug}` | `prompts/flows/evolve.md` |
- | "Show my skills", roll back or delete a generated skill | `prompts/flows/manage.md` |
- The create flow pulls in `prompts/flows/sources.md` for importing material and, for `celebrity`, `prompts/flows/celebrity_research.md`. Each flow names the prompts it needs; read those when the flow gets there, not up front.
- ## Rules for every flow
- - **Storage**: generated skills live under `./skills/colleague/{slug}/`, `./skills/relationship/{slug}/` or `./skills/celebrity/{slug}/` in the user's workspace. For a global path, pass `--base-dir` with that family's storage root.
- - **Writes**: create and update generated skills only through `tools/skill_writer.py`; never hand-build or hand-edit their files.
- - **Credentials**: App Secrets, access or refresh tokens, Bot Tokens and OAuth codes never enter the conversation. Never ask for them; the user runs a collector's `--setup` / `--login` in their own terminal. `prompts/flows/sources.md` has the details.
- ## Compatible hosts
- Claude Code, OpenClaw, Hermes, Codex, DeepSeek Harness, Pi coding agent, Grok Build and OpenCode. Invoke with `/distilly` in Claude Code, Hermes, DeepSeek Harness and Grok Build; `/distilly` or `/skill distilly` in OpenClaw; `$distilly` or `/skills` in Codex; `/skill:distilly` in Pi. OpenCode loads Skills natively and has no dedicated command. Grok Bot cannot import this directory directly; do not present this repository as a Grok Bot install.
README.md Β· README Β· 359 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <div align="center">
- <img src="docs/social-preview.png" alt="Distilly β Distill how they think into Person Profiles for Agents" width="100%">
- <br>
- # 𧬠Distilly
- **Formerly: Colleague Skill / colleague-skill.**
- ### Distill a person's experience, judgment, voice, and ways of working into a reusable Person Profile for AI agents and compatible bots.
- **Messages Β· documents Β· interviews Β· public sources β Distilly β Person Profile β Agent / Bot**
- [](LICENSE)
- [](https://python.org)
- [](https://agentskills.io)
- [](https://github.com/titanwings/distilly/stargazers)
- [](https://discord.gg/NVX66RxWZv)
- <br>
- <table>
- <tr><td align="left">
- π§βπΌ Your colleague quit, your mentor graduated, your teammate transferred β taking their whole playbook and context with them?<br>
- π Your family, old friends, partner drifting apart β and you want to hold on to the way it felt to be with them?<br>
- π Your favorite author, idol, thinker you'll never meet β but you want to know what they'd say about your question?
- </td></tr>
- </table>
- ### β¨ One project, many kinds of people.
- <br>
- Distilly is the person-modeling layer for agents. It turns the materials you provide into a portable, source-grounded Person Profile built from observable experience, decision patterns, expression, and ways of working; it does not claim to clone the person behind them.
- Colleagues Β· partners Β· family Β· old friends Β· idols Β· public figures Β· fictional characters β even yourself
- **Source material + your description β a source-grounded Person Profile β your Agent or compatible Bot**
- > A Person Profile is the reusable output. The current release packages each profile as an Agent Skill so supported hosts can install and invoke it. The canonical creator Skill is named `distilly`; install it in a `distilly` directory. The former name above remains for search continuity and project history.
- <br>
- [π What Distilly does](#-what-distilly-does-today) Β· [π¦ Data Sources](#-supported-data-sources) Β· [β‘ Install](#-install) Β· [π Usage](#-usage) Β· [β¨ Demo](#-demo) Β· [π Citation](#-citation) Β· [π¬ Discord](https://discord.gg/NVX66RxWZv)
- [**Chinese**](docs/lang/README_ZH.md) Β· [**Spanish**](docs/lang/README_ES.md) Β· [**German**](docs/lang/README_DE.md) Β· [**Japanese**](docs/lang/README_JA.md) Β· [**Russian**](docs/lang/README_RU.md) Β· [**Portuguese**](docs/lang/README_PT.md) Β· [**Korean**](docs/lang/README_KO.md)
- </div>
- ---
- <div align="center">
- ### π 2026.08.13 Milestone β **the project has passed 20K β!**
- Massive thanks to everyone who starred β we'll keep shipping, keep distilling.
- </div>
- > 𧬠**2026.08.24 Update** β The creator is now named **Distilly** end to end and documents native local Skill discovery for Claude Code, Hermes, OpenClaw, Codex, DeepSeek Harness, Pi, Grok Build, and OpenCode. Grok Bot is listed separately as a saved-Skill workflow preview.
- > π **2026.06.01 Update** β **[The COLLEAGUE.SKILL technical report](https://arxiv.org/pdf/2605.31264) is now available**. The most rewarding part was not simply publishing a paper, but seeing the community grow the gallery to 215 skills contributed by 165 people, with more than 100,000 stars across the skill cards. The paper's Acknowledgements explicitly recognize every community contributor.
- > πΊοΈ **2026.04.13** β **The Distilly Roadmap is live!** What began as Colleague Skill is growing beyond colleagues: distill people into Skills that Agents can reuse. π **[Full Roadmap](ROADMAP.md)** Β· **[π¬ Discord](https://discord.gg/NVX66RxWZv)**
- > π **2026.04.07** β Community gallery is live! Any skill / meta-skill can drive traffic directly to your own GitHub repo. No middleman. π **[titanwings.github.io/colleague-skill-site](https://titanwings.github.io/colleague-skill-site/)**
- <div align="center">
- Created by [@titanwings](https://github.com/titanwings)
- </div>
- ---
- ## π What Distilly does today
- ### 1οΈβ£ From Colleague Skill to Distilly
- The project is no longer limited to the colleague scenario. Its `distilly` creator builds source-grounded Person Profiles for three person families with one workflow, then packages each profile as an Agent Skill.
- ### 2οΈβ£ Three character families
- <table>
- <thead>
- <tr>
- <th width="33%" align="center">π§βπΌ colleague</th>
- <th width="33%" align="center">π relationship</th>
- <th width="33%" align="center">π celebrity</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td align="center"><sub>Coworkers Β· mentors Β· teammates Β· up/downstream partners</sub></td>
- <td align="center"><sub>Exes Β· partners Β· parents Β· friends Β· close family</sub></td>
- <td align="center"><sub>Public figures Β· creators Β· public voices Β· fictional characters</sub></td>
- </tr>
- <tr>
- <td><sub>Builds a Work Skill + Persona from material-derived technical standards, workflows, expression, and workplace behavior. Supports Lark / DingTalk / Slack collection.</sub></td>
- <td><sub>Organizes material-derived expression patterns, emotional triggers, conflict patterns, and repair patterns into a reusable Persona Skill.</sub></td>
- <td><sub>Ships with a <b>six-dimension research toolchain</b> (subtitles β transcript cleanup β research merge β quality check) for organizing observable decisions, expression, and mental models.</sub></td>
- </tr>
- </tbody>
- </table>
- Each family has its own source-collection strategy, analysis dimensions, and Person Profile structure.
- ### 3οΈβ£ More Agent hosts
- The old version only ran in Claude Code. Distilly now supports native local Skill discovery across eight agent hosts.
- <table>
- <tr>
- <td align="center" width="25%"><a href="https://claude.ai/code"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/hosts/claude-code-wordmark-dark.svg"><img src="docs/assets/hosts/claude-code-wordmark-light.svg" alt="Claude Code" height="28"></picture></a></td>
- <td align="center" width="25%"><a href="https://github.com/NousResearch/hermes-agent"><img src="docs/assets/hosts/hermes-agent-wordmark.png" alt="Hermes Agent" height="32"></a></td>
- <td align="center" width="25%"><a href="https://github.com/openclaw/openclaw"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/hosts/openclaw-wordmark-dark.svg"><img src="docs/assets/hosts/openclaw-wordmark-light.svg" alt="OpenClaw" height="38"></picture></a></td>
- <td align="center" width="25%"><a href="https://github.com/openai/codex" title="Codex"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/hosts/codex-mark-dark.png"><img src="docs/assets/hosts/codex-mark-light.png" alt="Codex" height="64"></picture></a></td>
- </tr>
- <tr>
- <td align="center" width="25%"><a href="https://github.com/deepseek-ai/deepseek-harness"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/hosts/deepseek-wordmark-dark.svg"><img src="docs/assets/hosts/deepseek-wordmark-light.svg" alt="DeepSeek Harness" height="32"></picture></a></td>
- <td align="center" width="25%"><a href="https://pi.dev/docs/latest/skills"><img src="docs/assets/hosts/pi-mark.svg" alt="Pi coding agent" height="46"></a></td>
- <td align="center" width="25%"><a href="https://docs.x.ai/build/features/skills-plugins-marketplaces"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/hosts/grok-build-mark-dark.png"><img src="docs/assets/hosts/grok-build-mark-light.png" alt="Grok Build" height="46"></picture></a></td>
- <td align="center" width="25%"><a href="https://opencode.ai/docs/skills"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/hosts/opencode-wordmark-dark.svg"><img src="docs/assets/hosts/opencode-wordmark-light.svg" alt="OpenCode" height="32"></picture></a></td>
- </tr>
- </table>
- **Grok Bot preview:** Grok Bot supports saved/private Skills, but its official docs do not describe direct local `SKILL.md` imports. Distilly's workflow can be migrated manually into a saved Skill; direct repo installation is not yet verified.
- Each generated Person Profile is packaged as an Agent Skill and can be installed into any supported host.
- ---
- ## π€ Personal Agents
- Distilly also targets the personal agents people now live with. Each one keeps its own memory and connected accounts, so a Person Profile is meant to carry over into them instead of starting from zero.
- <table>
- <tr>
- <td align="center" width="20%"><a href="https://x.ai"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/hosts/grok-build-mark-dark.png"><img src="docs/assets/hosts/grok-build-mark-light.png" alt="Grok Bot" height="46"></picture></a><br><b>Grok Bot</b><br><sub>saved Skill Β· preview</sub></td>
- <td align="center" width="20%"><a href="https://www.meta.ai"><img src="docs/assets/hosts/meta-mark.svg" alt="Meta Muse" height="40"></a><br><b>Meta Muse</b><br><sub>profile handoff Β· planned</sub></td>
- <td align="center" width="20%"><a href="https://openai.com"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/hosts/openai-mark-dark.svg"><img src="docs/assets/hosts/openai-mark-light.svg" alt="OpenAI Dots" height="40"></picture></a><br><b>OpenAI Dots</b><br><sub>profile handoff Β· planned</sub></td>
- <td align="center" width="20%"><a href="https://github.com/openclaw/openclaw"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/hosts/openclaw-wordmark-dark.svg"><img src="docs/assets/hosts/openclaw-wordmark-light.svg" alt="OpenClaw" height="38"></picture></a><br><sub>native Skill</sub></td>
- <td align="center" width="20%"><a href="https://github.com/NousResearch/hermes-agent"><img src="docs/assets/hosts/hermes-agent-wordmark.png" alt="Hermes Agent" height="32"></a><br><sub>native Skill</sub></td>
- </tr>
- </table>
- ---
- ## π¦ Supported Data Sources
- | Logo | Source | Messages | Docs / Wiki | Notes |
- |:----:|--------|:--------:|:-----------:|-------|
- | <img src="docs/assets/sources/lark-mark.png" alt="Lark" width="32" height="32"> | Lark (auto) | β API | β | Just enter a name, fully automatic |
- | <img src="docs/assets/sources/dingtalk-mark.jpg" alt="DingTalk" width="32" height="32"> | DingTalk (auto) | β οΈ Browser | β | DingTalk API doesn't support message history |
- | <img src="docs/assets/sources/slack-mark.png" alt="Slack" width="32" height="32"> | Slack (auto) | β API | β | Requires admin to install Bot; free plan limited to 90 days |
- | <picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/sources/x-mark-dark.svg"><img src="docs/assets/sources/x-mark-light.svg" alt="X" width="32" height="32"></picture> | Public X posts | β API | β | Optional, bounded celebrity research candidates through metered third-party service Xquik |
- | <img src="docs/assets/sources/wechat-mark.jpg" alt="WeChat" width="32" height="32"> | WeChat chat history | β SQLite | β | Export first with WeChatMsg or PyWxDump |
- | π | PDF / Images / Screenshots | β | β | Manual upload |
- | <img src="docs/assets/sources/lark-mark.png" alt="Lark" width="32" height="32"> | Lark JSON export | β | β | Manual upload |
- | βοΈ | Email `.eml` / `.mbox` | β | β | Manual upload |
- | π | Markdown / direct paste | β | β | Manual input |
- ---
- ## β‘ Install
- ### π€ For Agents
- Open any supported local Agent host and send:
- > Install Distilly from `https://github.com/titanwings/distilly`, then verify that this host can discover it.
- The Agent installs Distilly as a Skill named `distilly` in the correct host directory.
- ### π€ For Humans
- Clone Distilly into the Skills directory used by your host:
- ```bash
- git clone https://github.com/titanwings/distilly <DISTILLY_SKILL_DIR>
- ```
- Host paths, migration, Windows, generated-profile installation, and credential setup are in the **[Install Guide](INSTALL_EN.md)**.
- ---
- ## π Usage
- **New personal agent?** Say *"Use Distilly to set up my profile."* Distilly interviews you for about five minutes, shows you the profile, then adds a short summary to the file your agent reads every session (`~/.claude/CLAUDE.md` for Claude Code, `USER.md` for OpenClaw). The full profile stays local at `~/.distilly/owner/profile.md`.
- To profile someone else:
- In your Agent, say:
- > Use Distilly to create a Person Profile for `<person>`.
- Then:
- 1. Choose `colleague`, `relationship`, or `celebrity`.
- 2. Add a description or source material. Every field is optional.
- 3. Review the result and let Distilly generate the profile.
- The result is packaged as an Agent Skill named `{character}-{slug}`. For the optional celebrity research pipeline and advanced tools, see the **[Install Guide](INSTALL_EN.md)**.
- ---
- ## β¨ Demo
- One from each family.
- <br>
- ### π celebrity β distilling Andrej Karpathy
- > Six-dimension research: works Β· interviews Β· decisions Β· expression DNA Β· external evaluations Β· timeline<br>
- > Case adapted from community work [alchaincyf/karpathy-skill](https://github.com/alchaincyf/karpathy-skill)
- ```
- User β― Everyone's talking about Agents now β what do you think the 2026 AI Agent looks like?
- celebrity.skill β― Everyone's doing demos, nobody's doing eval.
- The Agent bottleneck was never model intelligence β it's scaffolding:
- a strict evaluation harness, fine-grained error replay,
- controllable tool-calling budgets, clean failure-mode analysis.
- Most products are still stuck at "wrap an API + a few tools + a system prompt."
- That's a demo, not an agent.
- In 2026 I'm not betting on the strongest model β I'm betting on the best
- scaffolding and the strictest eval.
- ```
- <br>
- ### π§βπΌ colleague β distilling a ByteDance L2-1 backend
- > Input: `ByteDance L2-1 backend engineer, INTJ, blame-shifter, ByteDance-style`
- ```
- User β― Can you review this API design?
- colleague.skill β― Hold on β what's the impact? You haven't explained the context.
- (after reading) N+1 query, fix it. Use the standard
- {code, message, data} response format. That's the spec,
- don't ask why.
- User β― This bug was introduced by you, right?
- colleague.skill β― Does the timeline match? That feature touched multiple places,
- there were other changes too.
- ```
- <br>
- ### π relationship β distilling someone you have a crush on
- > Upload half a year of chat logs + "sensitive, quiet but stubborn, will actually reply seriously when it matters"
- ```
- User β― Did you think about me today?
- relationship.skill β― ...I did, a little bit. Why are you asking?
- ```
- <div align="center">
- π More real-world cases in the **[community gallery](https://titanwings.github.io/colleague-skill-site/)** β 100+ skills and counting
- </div>
- ---
- ## π§ Features
- ### π§± Generated Skill Structure
- Distilly's current creator uses **Persona** as the universal base, with family-specific modules layered on top:
- | Family | Persona Content | Additional Modules |
- |--------|-----------------|-------------------|
- | π§βπΌ **colleague** | 6-layer personality: hard rules β identity β expression β decisions β interpersonal β Correction | β **Work Skill**: scope, workflow, output preferences, experience knowledge base |
- | π **relationship** | Expression DNA Β· emotional triggers Β· conflict pattern Β· repair pattern | β |
- | π **celebrity** | Mental models Β· decision heuristics Β· expression DNA Β· external-evaluation contrast | β Six-dimension research dossier (works / interviews / decisions / timeline...) |
- > **Execution**: Receive task β Persona selects material-derived preferences and tone β Additional modules fill in execution detail β Produce a source-grounded response
- ### 𧬠Evolution
- - π₯ **Append files** β auto-analyze delta β merge into relevant sections, never overwrite existing conclusions
- - π¬ **Conversation correction** β say "they wouldn't do that, they'd be xxx" β writes to the Correction layer, takes effect immediately
- - π°οΈ **Version control** β auto-archive on every update, rollback to any previous version
- - π¬ **Celebrity research pipeline** β subtitles β transcript cleanup β six-dimension research β quality check
- ---
- ## β οΈ Notes
- **Source material quality = Person Profile quality** β and quality sources differ across families:
- | Family | Source priority (high β low) |
- |--------|------------------------------|
- | π§βπΌ **colleague** | Their **own long-form writing** (design docs / review comments) **βΊ** **decision-making replies** **βΊ** casual group chat |
- | π **relationship** | Complete chat history **βΊ** letters / social posts / diaries **βΊ** third-party descriptions |
- | π **celebrity** | First-person books / blogs / long interviews **βΊ** decision records (launches, commits, Q&A) **βΊ** verified first-person short-form posts **βΊ** third-party commentary |
- - **colleague** Lark-compatible auto-collection: requires adding the App bot to relevant group chats
- - **relationship**: longer time spans are better; material covering both conflict and repair is ideal
- - **celebrity**: avoid feeding only second-hand interpretations
- - This is still a demo version β please file issues if you find bugs!
- ---
- ## π Technical Report
- > **[COLLEAGUE.SKILL: Automated AI Skill Generation via Expert Knowledge Distillation](https://arxiv.org/pdf/2605.31264)** ([arXiv](https://arxiv.org/abs/2605.31264) Β· [arXiv PDF](https://arxiv.org/pdf/2605.31264))
- >
- > This is the paper for **COLLEAGUE.SKILL / colleague-skill**, Distilly's predecessor. It covers the Work Skill + Persona two-layer architecture, multi-source data collection, and Skill generation mechanics β the theoretical foundation for today's `colleague` family. Separate papers on the relationship / celebrity family extensions are planned.
- ---
- ## π Citation
- If you use **Distilly** or **COLLEAGUE.SKILL** in your research or applications, please cite the technical report:
- ```bibtex
- @misc{zhou2026colleagueskill,
- title = {COLLEAGUE.SKILL: Automated AI Skill Generation via Expert Knowledge Distillation},
- author = {Tianyi Zhou and Dongrui Liu and Leitao Yuan and Jing Shao and Xia Hu},
- year = {2026},
- eprint = {2605.31264},
- archivePrefix = {arXiv},
- primaryClass = {cs.AI},
- url = {https://arxiv.org/abs/2605.31264}
- }
- ```
- You can also use the machine-readable citation metadata in [CITATION.cff](CITATION.cff).
- ---
- ## β Star History
- <a href="https://star-history.dera.page/#titanwings/colleague-skill&type=date&legend=top-left">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://star-history.dera.page/svg?repos=titanwings%2Fdistilly&type=date&theme=dark&legend=top-left" />
- <source media="(prefers-color-scheme: light)" srcset="https://star-history.dera.page/svg?repos=titanwings%2Fdistilly&type=date&legend=top-left" />
- <img alt="Star History Chart" src="https://star-history.dera.page/svg?repos=titanwings%2Fdistilly&type=date&legend=top-left" />
- </picture>
- </a>
- ---
- <div align="center">
- **MIT License** Β© [titanwings](https://github.com/titanwings)
- </div>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itβs helped, pass it on.