# ๐Ÿงฌ dot-skill๏ผˆๅŒไบ‹.skill๏ผ‰ ### *"You folks building LLMs are all code-sages! Flesh is weak! Ascend to cyberspace!"* [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![Python 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue.svg)](https://python.org) [![AgentSkills](https://img.shields.io/badge/AgentSkills-Standard-green)](https://agentskills.io) [![Stars](https://img.shields.io/github/stars/titanwings/colleague-skill?style=social)](https://github.com/titanwings/colleague-skill/stargazers) [![Claude Code](https://img.shields.io/badge/Claude%20Code-Skill-blueviolet)](https://claude.ai/code) [![Hermes](https://img.shields.io/badge/Hermes-Skill-orange)](https://github.com/titanwings/colleague-skill) [![OpenClaw](https://img.shields.io/badge/OpenClaw-Skill-teal)](https://github.com/titanwings/colleague-skill) [![Codex](https://img.shields.io/badge/Codex-Skill-black)](https://github.com/titanwings/colleague-skill) [![Discord](https://img.shields.io/badge/Discord-Join%20Community-5865F2?logo=discord&logoColor=white)](https://discord.gg/NVX66RxWZv)
๐Ÿง‘โ€๐Ÿ’ผ  Your colleague quit, your mentor graduated, your teammate transferred โ€” taking their whole playbook and context with them?
๐Ÿ’ž  Your family, old friends, partner drifting apart โ€” and you want to hold on to the way it felt to be with them?
๐ŸŒŸ  Your favorite author, idol, thinker you'll never meet โ€” but you want to know what they'd say about your question?
### โœจ dot-skill solves all three.
Upgraded from **colleague.skill** to **dot-skill** โ€” not just colleagues, **anyone** can be distilled into a Skill Colleagues ยท partners ยท family ยท old friends ยท idols ยท public figures ยท fictional characters โ€” even yourself **Source material + your description โ†’ an AI Skill that genuinely thinks like them** Thinks in their frame, speaks in their voice
[๐Ÿ†• What's new](#-whats-new-in-this-major-release) ยท [๐Ÿ“ฆ Data Sources](#-supported-data-sources) ยท [โšก Install](#-install) ยท [๐Ÿš€ Usage](#-usage) ยท [โœจ Demo](#-demo) ยท [๐Ÿ“ Citation](#-citation) ยท [๐Ÿ’ฌ Discord](https://discord.gg/NVX66RxWZv) [**ไธญๆ–‡**](docs/lang/README_ZH.md) ยท [**Espaรฑol**](docs/lang/README_ES.md) ยท [**Deutsch**](docs/lang/README_DE.md) ยท [**ๆ—ฅๆœฌ่ชž**](docs/lang/README_JA.md) ยท [**ะ ัƒััะบะธะน**](docs/lang/README_RU.md) ยท [**Portuguรชs**](docs/lang/README_PT.md) ยท [**ํ•œ๊ตญ์–ด**](docs/lang/README_KO.md)
---
### ๐ŸŽ‰ 2026.04.19 Milestone โ€” **dot-skill just hit 15k โญ!** Massive thanks to everyone who starred โ€” we'll keep shipping, keep distilling.
> ๐Ÿ“ **2026.06.01 Update** โ€” **[COLLEAGUE.SKILL ๆŠ€ๆœฏๆŠฅๅ‘Š](colleague_skill.pdf) ๅทฒไธŠ็บฟ**๏ผ›่ฟ™ๆฌกๆœ€ๅผ€ๅฟƒ็š„ไธๅชๆ˜ฏๅ‘ไบ†็ฏ‡ paper๏ผŒ่€Œๆ˜ฏ็คพๅŒบไธ€่ตทๆŠŠ gallery ๆŽจๅˆฐ 215 ไธช skillsใ€165 ไฝ่ดก็Œฎ่€…ๅ’Œ 100k+ skill-card ็ดฏ่ฎก stars๏ผŒ่ฎบๆ–‡ Acknowledgements ไนŸไธ“้—จๆ”ถๅฝ•ๅนถๆ„Ÿ่ฐขไบ†ๆ‰€ๆœ‰็คพๅŒบ่ดก็Œฎ่€…ใ€‚ > ๐Ÿ“ข **2026.05.11 Update** โ€” **WeChat group 12 is live!** Come hang out with the dot-skill community โ€” share skills, discuss features, trade tips. > > dot-skill WeChat group QR > > QR refreshes every 7 days (expires 2026-05-18) โ€” if expired, ping me on Discord. > ๐Ÿ—บ๏ธ **2026.04.13** โ€” **dot-skill Roadmap is live!** colleague.skill is evolving into **dot-skill** โ€” distill anyone, not just colleagues. ๐Ÿ‘‰ **[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/)**
Created by [@titanwings](https://github.com/titanwings) ยท Powered by **Shanghai AI Lab ยท AI Safety Center**
--- ## ๐Ÿ†• What's new in this major release? ### 1๏ธโƒฃ From colleague-skill to dot-skill No longer only built around the "colleague" scenario. A unified `/dot-skill` entrypoint sits on a general-purpose skill engine โ€” one engine distills anyone, instead of being a colleague-specific script. ### 2๏ธโƒฃ Three character families
๐Ÿง‘โ€๐Ÿ’ผ colleague ๐Ÿ’ž relationship ๐ŸŒŸ celebrity
Coworkers ยท mentors ยท teammates ยท up/downstream partners Exes ยท partners ยท parents ยท friends ยท close family Public figures ยท creators ยท public voices ยท fictional characters
Work Skill + Persona two-layer architecture โ€” learns both their technical standards and workflows, and their manner of speaking and workplace posture. Supports Feishu / DingTalk / Slack auto-collection. ๐Ÿ†• Photo-sharing feature coming soon โ€” your distilled relationship won't just reply to messages; it'll send photos and share slices of its day, the way a real person would. Ships with a complete six-dimension research toolchain (subtitles โ†’ transcript cleanup โ†’ research merge โ†’ quality check). Not mimicking tone โ€” reproducing their mental models and decision frameworks.
Each family has its own prompt pipeline, source-collection strategy, and generation template. ### 3๏ธโƒฃ More Agent hosts The old version only ran in Claude Code. Now it's cross-host across four: Compatible hosts: | Host | Description | |------|-------------| | ๐ŸŸฃ **Claude Code** | Native slash-command support | | ๐ŸŸ  **Hermes Agent** | One-command install, `/dot-skill` works directly | | ๐Ÿ”ต **OpenClaw** | Fully compatible | | โšซ **Codex** | Invoke by skill name | Generated character Skills can also be one-command installed into any host. --- ## ๐Ÿ“ฆ Supported Data Sources | Source | Messages | Docs / Wiki | Spreadsheets | Notes | |--------|:--------:|:-----------:|:------------:|-------| | ๐ŸŸข Feishu (auto) | โœ… API | โœ… | โœ… | Just enter a name, fully automatic | | ๐ŸŸก DingTalk (auto) | โš ๏ธ Browser | โœ… | โœ… | DingTalk API doesn't support message history | | ๐ŸŸฃ Slack (auto) | โœ… API | โ€” | โ€” | Requires admin to install Bot; free plan limited to 90 days | | ๐Ÿ’ฌ WeChat chat history | โœ… SQLite | โ€” | โ€” | Export first with WeChatMsg / PyWxDump / ็•™็—• | | ๐Ÿ“„ PDF / Images / Screenshots | โ€” | โœ… | โ€” | Manual upload | | ๐Ÿ“ฆ Feishu JSON export | โœ… | โœ… | โ€” | Manual upload | | โœ‰๏ธ Email `.eml` / `.mbox` | โœ… | โ€” | โ€” | Manual upload | | ๐Ÿ“ Markdown / direct paste | โœ… | โœ… | โ€” | Manual input | --- ## โšก Install It's 2026 โ€” you have an Agent, let it install itself. Open your Claude Code / Hermes / OpenClaw / Codex and hand it this line: > Install the dot-skill skill for me: `https://github.com/titanwings/colleague-skill` The Agent will detect the current host's skills directory, clone the repo, and register the entrypoint. Once done, type `/dot-skill` in any host to launch.
๐Ÿ› ๏ธ Want to install it yourself? Click for paths
```bash git clone https://github.com/titanwings/colleague-skill ``` | Host | `` path | |------|-----------------| | Claude Code | `~/.claude/skills/dot-skill` | | OpenClaw | `~/.openclaw/workspace/skills/dot-skill` | | Codex | `~/.codex/skills/dot-skill` | | Hermes | After clone, run `python3 tools/install_hermes_skill.py --force` |
Generated character Skills can be published with `tools/install_claude_generated_skill.py`, `tools/install_openclaw_generated_skill.py`, and `tools/install_codex_generated_skill.py`. > For Feishu/DingTalk auto-collection credentials, publishing a generated character Skill to any host, Windows-specific handling, etc., see **[Detailed Install Guide (INSTALL.md)](INSTALL.md)** --- ## ๐Ÿš€ Usage In the host where dot-skill is installed, launch it โ€” type `/dot-skill`, or just tell your Agent "start dot-skill". It first asks which family you want to distill: `colleague` ยท `relationship` ยท `celebrity`. Then enter alias, basic profile, personality tags, and pick a data source. All fields can be skipped โ€” even a description alone can generate a Skill. Once created, invoke the generated Skill with `/{character}-{slug}`. ### ๐ŸŽ›๏ธ Commands | Command | Description | |---------|-------------| | `/dot-skill` | Canonical unified entrypoint | | `/{character}-{slug}` | Invoke full Skill (Persona + Work) | | `/{character}-{slug}-work` | Work capabilities only | | `/{character}-{slug}-persona` | Persona only | | `python3 tools/skill_writer.py --action list ...` | List generated Skills across all three families | | `python3 tools/version_manager.py --action rollback ...` | Roll back a Skill version | ### ๐Ÿ”ฌ Celebrity Research Toolchain The `celebrity` family ships with an end-to-end research toolchain, from subtitles to a finished draft: ```bash # Download video subtitles bash tools/research/download_subtitles.sh "" "./tmp/subtitles" # Subtitles โ†’ transcript python3 tools/research/srt_to_transcript.py "./tmp/subtitles/example.srt" # Merge research notes python3 tools/research/merge_research.py "./skills/celebrity/" # Quality check python3 tools/research/quality_check.py "./skills/celebrity//SKILL.md" ``` --- ## โœจ Demo One from each family.
### ๐ŸŒŸ celebrity โ€” distilling Andrej Karpathy > Six-dimension research: works ยท interviews ยท decisions ยท expression DNA ยท external evaluations ยท timeline
> 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. ```
### ๐Ÿง‘โ€๐Ÿ’ผ 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. ```
### ๐Ÿ’ž 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? ```
๐Ÿ“š More real-world cases in the **[community gallery](https://titanwings.github.io/colleague-skill-site/)** โ€” 100+ skills and counting
--- ## ๐Ÿ”ง Features ### ๐Ÿงฑ Generated Skill Structure dot-skill 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 decides attitude & tone โ†’ Additional modules fill in execution detail โ†’ Output in their voice ### ๐Ÿงฌ 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 --- ## ๐Ÿ“‚ Project Structure This project follows the [AgentSkills](https://agentskills.io) open standard. The entire repo is a skill directory. Generated colleague skills live under `./skills/colleague`: ``` dot-skill/ โ”œโ”€โ”€ SKILL.md # skill entry point (official frontmatter) โ”œโ”€โ”€ prompts/ # prompt system across three families โ”‚ โ”œโ”€โ”€ intake.md # [colleague] info intake โ”‚ โ”œโ”€โ”€ work_analyzer.md # [colleague] work capability extraction โ”‚ โ”œโ”€โ”€ persona_analyzer.md # [colleague] personality extraction โ”‚ โ”œโ”€โ”€ work_builder.md # [colleague] work.md generation โ”‚ โ”œโ”€โ”€ persona_builder.md # [colleague] persona.md 6-layer structure โ”‚ โ”œโ”€โ”€ merger.md # [shared] incremental merge logic โ”‚ โ”œโ”€โ”€ correction_handler.md # [shared] conversation correction โ”‚ โ”œโ”€โ”€ relationship/ # [relationship] emotion/conflict/repair prompts โ”‚ โ””โ”€โ”€ celebrity/ # [celebrity] six-dimension research + mental-model prompts โ”œโ”€โ”€ tools/ # Python tools โ”‚ โ”œโ”€โ”€ feishu_auto_collector.py # [colleague] Feishu auto-collector โ”‚ โ”œโ”€โ”€ dingtalk_auto_collector.py # [colleague] DingTalk auto-collector โ”‚ โ”œโ”€โ”€ slack_auto_collector.py # [colleague] Slack auto-collector โ”‚ โ”œโ”€โ”€ email_parser.py # [shared] email parser โ”‚ โ”œโ”€โ”€ research/ # [celebrity] celebrity research toolchain โ”‚ โ”‚ โ”œโ”€โ”€ download_subtitles.sh # subtitle download โ”‚ โ”‚ โ”œโ”€โ”€ transcribe_audio.py # audio โ†’ text โ”‚ โ”‚ โ”œโ”€โ”€ srt_to_transcript.py # subtitles โ†’ transcript โ”‚ โ”‚ โ”œโ”€โ”€ merge_research.py # six-dimension research merge โ”‚ โ”‚ โ””โ”€โ”€ quality_check.py # quality check โ”‚ โ”œโ”€โ”€ install_*_skill.py # [shared] multi-host one-shot installers โ”‚ โ”œโ”€โ”€ skill_writer.py # [shared] skill file management โ”‚ โ””โ”€โ”€ version_manager.py # [shared] version archive & rollback โ”œโ”€โ”€ skills/ # generated Skills (gitignored) โ”‚ โ”œโ”€โ”€ colleague/ # colleagues โ”‚ โ”œโ”€โ”€ relationship/ # close relationships โ”‚ โ””โ”€โ”€ celebrity/ # public figures โ”œโ”€โ”€ docs/PRD.md โ”œโ”€โ”€ requirements.txt โ””โ”€โ”€ LICENSE ``` --- ## โš ๏ธ Notes **Source material quality = Skill 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) **โ€บ** third-party commentary | - **colleague** Feishu 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](colleague_skill.pdf)** ([arXiv](https://arxiv.org/abs/2605.31264) ยท [arXiv PDF](https://arxiv.org/pdf/2605.31264)) > > This is the paper for **colleague.skill**, dot-skill'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 **dot-skill** 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 Star History Chart ---
**MIT License** ยฉ [titanwings](https://github.com/titanwings)