FreePublished on GitHub

distilly

Create reusable person profiles from information about yourself, colleagues, personal relationships, or celebrities. Use them to give an agent context about who it serves or other people, then update and manage the generated profiles as information changes.

OriginalShow the original 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.

titanwings/distilly

See how to install

Good for

Setting up your profile for a personal agent
Creating a reusable profile from colleague materials
Organizing information about personal relationships or celebrities
Updating and managing existing person profiles

Files included (133)

SKILL.md3.8 KB
.github/ISSUE_TEMPLATE/bug_report.md753 B
.github/ISSUE_TEMPLATE/config.yml310 B
.github/ISSUE_TEMPLATE/feature_request.md503 B
.github/ISSUE_TEMPLATE/question.md418 B
.github/PULL_REQUEST_TEMPLATE.md978 B
.github/workflows/ci.yml1.4 KB
.github/workflows/publish-package.yml551 B
.gitignore395 B
.npmrc48 B
bin/distilly.mjs5.6 KB
CITATION.cff1.1 KB
CONTRIBUTING.md4.4 KB
docs/assets/hosts/claude-code-wordmark-dark.svg8.1 KB
docs/assets/hosts/claude-code-wordmark-light.svg6.8 KB
docs/assets/hosts/codex-mark-dark.png42.9 KB
docs/assets/hosts/codex-mark-light.png40.7 KB
docs/assets/hosts/deepseek-wordmark-dark.svg9.8 KB
docs/assets/hosts/deepseek-wordmark-light.svg9.8 KB
docs/assets/hosts/grok-build-mark-dark.png11.1 KB
docs/assets/hosts/grok-build-mark-light.png11.4 KB
docs/assets/hosts/hermes-agent-wordmark.png12.0 KB
docs/assets/hosts/meta-mark.svg1.3 KB
docs/assets/hosts/openai-mark-dark.svg1.5 KB
docs/assets/hosts/openai-mark-light.svg1.5 KB
docs/assets/hosts/openclaw-wordmark-dark.svg63.6 KB
docs/assets/hosts/openclaw-wordmark-light.svg63.6 KB
docs/assets/hosts/opencode-wordmark-dark.svg1.1 KB
docs/assets/hosts/opencode-wordmark-light.svg1.1 KB
docs/assets/hosts/pi-mark.svg618 B
docs/assets/hosts/README.md1.6 KB
docs/assets/sources/dingtalk-mark.jpg1.5 KB
docs/assets/sources/lark-mark.png3.8 KB
docs/assets/sources/README.md602 B
docs/assets/sources/slack-mark.png2.8 KB
docs/assets/sources/wechat-mark.jpg4.1 KB
docs/assets/sources/x-mark-dark.svg292 B
docs/assets/sources/x-mark-light.svg292 B
docs/lang/README_DE.md2.0 KB
docs/lang/README_ES.md1.9 KB
docs/lang/README_JA.md2.2 KB
docs/lang/README_KO.md2.0 KB
docs/lang/README_PT.md1.9 KB
docs/lang/README_RU.md2.7 KB
docs/lang/README_ZH.md18.3 KB
docs/social-preview.png839.8 KB
INSTALL_EN.md6.5 KB
INSTALL.md20.6 KB
LICENSE1.0 KB
package.json1.0 KB
prompts/celebrity/budget_unfriendly/audit.md3.9 KB
prompts/celebrity/budget_unfriendly/framework.md7.4 KB
prompts/celebrity/budget_unfriendly/persona_analyzer.md3.3 KB
prompts/celebrity/budget_unfriendly/persona_builder.md3.3 KB
prompts/celebrity/budget_unfriendly/synthesis.md1.1 KB
prompts/celebrity/budget_unfriendly/template.md3.7 KB
prompts/celebrity/budget_unfriendly/validation.md1.3 KB
prompts/celebrity/intake.md5.2 KB
prompts/celebrity/merger.md6.8 KB
prompts/celebrity/persona_analyzer.md5.5 KB
prompts/celebrity/persona_builder.md6.1 KB
prompts/celebrity/research.md20.1 KB
prompts/colleague/intake.md5.3 KB
prompts/colleague/merger.md2.4 KB
prompts/colleague/persona_analyzer.md8.7 KB
prompts/colleague/persona_builder.md5.1 KB
prompts/flows/celebrity_research.md10.0 KB
prompts/flows/create.md7.7 KB
prompts/flows/evolve.md2.4 KB
prompts/flows/manage.md680 B
prompts/flows/owner.md2.1 KB
prompts/flows/sources.md11.6 KB
prompts/owner/intake.md5.4 KB
prompts/owner/profile_builder.md2.5 KB
prompts/relationship/intake.md2.2 KB
prompts/relationship/merger.md1.1 KB
prompts/relationship/persona_analyzer.md1.9 KB
prompts/relationship/persona_builder.md1.7 KB
prompts/shared/correction_handler.md3.3 KB
prompts/shared/work_analyzer.md5.3 KB
prompts/shared/work_builder.md2.6 KB
README.md19.2 KB
requirements-optional.txt518 B
requirements.txt118 B
ROADMAP.md5.0 KB
ruff.toml130 B
tests/_paths.py302 B
tests/e2e/owner_discovery/.gitignore54 B
tests/e2e/owner_discovery/mock_mcp.py4.9 KB
tests/e2e/owner_discovery/README.md1.2 KB
tests/e2e/owner_discovery/setup.sh545 B
tests/e2e/owner_discovery/turn.sh1.0 KB
tests/test_cli_lifecycle.py22.4 KB
tests/test_config_migration.py1.6 KB
tests/test_credentials.py5.0 KB
tests/test_install_claude_generated_skill.py3.2 KB
tests/test_install_distilly.py7.6 KB
tests/test_install_generated_skill.py4.3 KB
tests/test_install_openclaw_and_codex.py5.2 KB
tests/test_owner_profile.py9.7 KB
tests/test_owner_sources.py5.8 KB
tests/test_research_tools.py8.5 KB
tests/test_skill_entrypoint_docs.py16.2 KB
tests/test_skill_writer.py32.0 KB
tests/test_translation_sync.py3.7 KB
tests/test_xquik_public_posts.py8.6 KB
tools/credentials.py7.3 KB
tools/dingtalk_auto_collector.py28.0 KB
tools/email_parser.py9.8 KB
tools/feishu_auto_collector.py39.0 KB
tools/feishu_browser.py12.5 KB
tools/feishu_mcp_client.py11.5 KB
tools/feishu_parser.py7.4 KB
tools/hosts.json1.0 KB
tools/hosts.py1.4 KB
tools/install_claude_generated_skill.py3.6 KB
tools/install_distilly.py3.3 KB
tools/install_generated_skill_common.py3.9 KB
tools/install_generated_skill.py1.5 KB
tools/owner_profile.py11.3 KB
tools/owner_sources.py13.0 KB
tools/research/__init__.py72 B
tools/research/download_subtitles.sh887 B
tools/research/merge_research.py10.0 KB
tools/research/quality_check.py10.2 KB
tools/research/srt_to_transcript.py2.7 KB
tools/research/transcribe_audio.py9.9 KB
tools/research/xquik_public_posts.py14.3 KB
tools/skill_presets.py12.3 KB
tools/skill_schema.py15.7 KB
tools/skill_writer.py25.1 KB
tools/slack_auto_collector.py25.6 KB
tools/version_manager.py7.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Report a problem with this skill

Install

Install with a command

npx skills add https://github.com/titanwings/distilly --skill distilly

Paste it into your terminal and run it (requires Node.js). You can choose which agents to install it for, such as Claude Code or Codex.

Ask your agent

Please install the following Agent Skill.
https://github.com/titanwings/distilly

First review SKILL.md and the bundled files and confirm there is nothing suspicious (such as sending data externally or reading credentials). Then place it in ~/.claude/skills/distilly/ for Claude Code, or ~/.agents/skills/distilly/ for Codex.

Send this text to Claude Code or Codex as is. It checks the contents before installing.

View source on GitHub

Repository: titanwings/distilly
Stars: 25,774
Forks: 2,379
Category: Productivity
License: MIT
Original language: English
Last updated: Oct 13, 2026

A skill is a set of instructions and scripts for an agent. cccskills does not guarantee that skills are safe. Review the contents before you install.