mrkeyoor.com_
Tue 01 Sept 17:41 UTC
LLM Toolsevaluationupdated 26 Aug 2026

distilly review

Colleague Skill has been renamed Distilly. It turns messages, documents, interviews, and public sources into a portable Person Profile that Claude Code, Codex, and other skill-aware agents can load to imitate a person's working preferences or communication patterns without claiming to clone that person.

+235stars / 7d
Verdict

Our Distilly run installed 42 packages, built in 5 seconds, and passed all 35 tests with 0 audit findings, so the code is easy to trial. Use it for a consented work profile when a portable Claude Code or Codex skill is more useful than a full memory service. Do not feed it private relationship or workplace archives until you have your own consent, redaction, access, and deletion process, because the repository's stronger privacy gates are still under review.

We ran it

Lab card: what happened when we ran distillyScreenshot of distilly (github.com/titanwings/distilly)
Install✓ · 19s42 packages · 193 MB
Build✓ · 5s
Tests✓ · 12s35 passed · 0 failed of 35 (pytest)
Known vulns0(pip-audit)
Repo107 files~8,162 lines of source · 5.5 MB · 1 CI workflows · tests dir

Answers from our run

Does distilly build from source?

Dependencies installed in 19 seconds (42 packages), and the build succeeded in 5 seconds. We cloned commit 7a77c7c into a clean Debian container with 3 CPUs and no project-specific setup.

Do distilly's tests pass?

Yes: 35 of 35 passed when we ran the project's own test command (pytest). Some failures need services or credentials a bare container does not have.

Does distilly have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use distilly?

Anyone creating a relationship or colleague profile without informed consent: the workflow can ingest private chats, email, documents, and third-party messages.

What are the alternatives to distilly?

Anthropic Skills, Mem0, Letta. Our Distilly run installed 42 packages, built in 5 seconds, and passed all 35 tests with 0 audit findings, so the code is easy to trial.

Setup4/5Core install and tests are clean; collectors add browser and API setup
Docs4/5Detailed host paths, collectors, migration, and profile workflows
Community4/5Pushed August 2026 with active multilingual issues and pull requests
Maturity3/5Working skill pipeline, while privacy gates remain under review

Who it’s for

Teams preserving a departing colleague's review habits, workflows, and decision rules with permission.
Claude Code or Codex users who want a local Agent Skill built from source material they control.
Researchers studying source-grounded persona and work-skill generation.
Users prepared to review the generated profile, correct it, and keep the underlying material private.

Who it’s NOT for

Anyone creating a relationship or colleague profile without informed consent: the workflow can ingest private chats, email, documents, and third-party messages.
Teams needing privacy screening as a merged, released safeguard: explicit consent gates and a relationship-data screener are still in open pull request 136.
Operators who cannot audit credential handling: open security issue 113 says collector setup prompts echoed API tokens and passwords into terminal scrollback.
Users expecting a factual digital clone: the README says the output is a source-grounded profile and does not claim to reproduce the person.
International Lark tenants needing automatic collection: the install guide says current routing supports China-region Feishu endpoints, not larksuite.com tenants.

Setup reality

Our sandbox installed 42 Python packages in 19 seconds and used 193 MB. The build succeeded in 5 seconds. Pytest then passed all 35 tests in 12 seconds, and pip-audit reported 0 known vulnerabilities.

Basic use requires a skill-aware host and a clone placed in that host's distilly directory. Generated profiles are local SKILL.md files. Automated collection adds credentials for Feishu, DingTalk, or Slack; browser collection requires Playwright and Chromium.

The checkout was 5.5 MB with 107 files and about 8,162 source lines. Sensitive inputs remain the harder setup problem: permissions, consent, retention, third-party messages, and safe secret storage need decisions before collection begins.

Distilly generates a profile file, not a living agent

The project formerly called Colleague Skill is now Distilly. Its creator takes material about one person and writes a Person Profile packaged as an Agent Skill. Three profile families cover colleagues, relationships, and public or fictional figures. The result contains observed preferences, decision patterns, expression, and corrections that a compatible agent can consult while answering or working.

That output is deliberately smaller than an agent platform. It does not run a model service, maintain a server, or claim to clone a mind. A generated profile is a SKILL.md with installation metadata, and the host supplies the model and tools. This makes profiles portable, inspectable, and easy to delete, although their quality and safety depend on the source material and generated instructions.

Eight hosts can discover the same skill format

The August 24, 2026 README lists native local skill discovery for Claude Code, Hermes, OpenClaw, Codex, DeepSeek Harness, Pi, Grok Build, and OpenCode. Each host uses a different directory and invocation style. The install guide maps the user and project locations, while dedicated scripts copy Distilly into canonical Codex, Hermes, or OpenClaw locations.

Claude Code loads it from a distilly directory under its skills path; Codex uses .agents/skills/distilly at project level or the user equivalent. Generated profiles can then be installed for a chosen host. The installer copies only the profile's SKILL.md and a small manifest, not the private source directory. That boundary is sensible, but users should inspect the installed file because it is still agent instruction.

What happened when we ran it

Our sandbox cloned commit 7a77c7c into a fresh Debian container with 3 CPUs and 8 GB of RAM. Installing 42 Python packages took 19 seconds and consumed 193 MB. The build completed in 5 seconds, then pytest passed 35 of 35 tests in 12 seconds. Pip-audit reported 0 known vulnerabilities.

The repository was compact beside the other projects in this batch: 107 files, about 8,162 source lines, and 5.5 MB checked out. It had one CI workflow, a tests directory, and no Dockerfile. These numbers cover the checked-out Python tools and tests. We did not connect a workplace account, upload real chat history, or judge whether a generated profile resembled a person.

The clean test result lowers the cost of trying the local pipeline. It does not validate the social claim at the center of the project. A profile can quote the right phrases and still misstate someone's judgment, flatten context, or preserve information they expected to disappear. Evaluation needs the subject or a knowledgeable reviewer, plus examples that were withheld from generation.

Collection reaches into sensitive systems

Distilly accepts pasted text, Markdown, PDFs, images, email archives, Feishu exports, Slack, DingTalk, WeChat history, and bounded public X material. Automated Feishu collection can read group messages and documents; private-chat collection requires user identity, OAuth scopes, and a chat ID. Slack requires an administrator to install a bot, while DingTalk history uses browser collection because its API does not provide it.

Those sources contain more than the target person's words. Group chats include coworkers, private conversations include both participants, and emails can include customers or confidential attachments. The install guide says not to commit credentials and stores collector configuration under ~/.distilly/. International Lark routing is not implemented; the current collector targets China-region Feishu endpoints. Collection breadth is useful only when authorization matches it.

Privacy controls are still being strengthened

Open pull request 136 proposes a blocking privacy screen for relationship material, explicit consent before writing files, separate consent before host installation, and another gate before gallery publication. It would flag identifiers, third-party speakers, and sensitive categories while stating what pattern matching cannot detect. The proposal says silence must not count as consent.

The important word is proposes. Until that pull request is merged into the branch you install, buyers should not describe those checks as shipped behavior. A local wrapper can require written consent, scan and redact inputs, restrict output permissions, set a retention date, and prohibit publication. Relationship archives deserve the strictest treatment because a participant may possess the chat export without having permission to turn the other person into an agent persona.

Open security issue 113 adds another practical warning: setup flows in several collectors used ordinary input() for secrets, causing tokens or passwords to appear in terminal scrollback and recordings. Open pull requests reference a move to hidden prompts, but an operator should inspect the exact checkout. Prefer short-lived OAuth tokens, limit scopes, and run collection from a private shell whose logs are controlled.

Current activity is strong, while release packaging is informal

The requested titanwings/colleague-skill URL now resolves to titanwings/distilly. GitHub reported 24,015 stars, 37 combined open issues and pull requests, and a last push on August 25, 2026. The latest-release API returned no release object, so pinning a commit is safer than assuming a stable GitHub release channel.

The README is English, the creator skill supports English and Chinese, and translated READMEs cover seven additional languages. The MIT license is simple. Distilly is worth using for a willing colleague who can review the output and correct errors. Its clean 35-test run is encouraging; the unresolved privacy and secret-input work keeps private relationship archives outside our recommendation for now.

Alternatives

ProjectWhat it isPick it when
Anthropic Skills gh↗A collection of general Agent Skills and examples without person-profile extraction.pick this instead when you need reusable task instructions rather than a model of one person's behavior.
Mem0 gh↗A memory layer that stores and retrieves facts for AI applications.pick this instead when the requirement is user memory across conversations, not a portable persona skill.
LettaA framework for stateful agents with persistent memory and tool use.pick this instead when you need a long-running agent runtime rather than a generated profile file.

What people are saying

  1. [github-trending] titanwings/colleague-skill

Sources

  1. Distilly README
  2. Distilly repository
  3. Distilly install guide
  4. Privacy screening and consent pull request
  5. Collector secret prompt issue
  6. COLLEAGUE.SKILL technical report

More llm tools reviews

rig · open-knowledge · graphiti · cve-mcp-server · minimind · SillyTavern · the whole board →