"Every goodbye deserves a gentle place to rest."
Distill your ex into an AI Skill — let them live on in your terminal.
Provide source materials from your past relationship (chat logs, photos, social media posts) plus your own descriptions. Generate an AI Skill that truly sounds like them — speaks with their catchphrases, replies in their style, remembers the places you went together.
⚠️ This project is for personal reflection and emotional healing only. Not for harassment, stalking, or privacy invasion.
Installation · Usage · Examples · 中文
# Install to current project
mkdir -p .claude/skills
git clone https://cnb.cool/T_T/ex-skills .claude/skills/create-ex
# Or install globally
git clone https://cnb.cool/T_T/ex-skills ~/.claude/skills/create-ex
pip3 install -r requirements.txt
In Claude Code, type:
/create-ex
Follow the prompts: enter a codename, basic info, personality traits, then choose data sources. All fields except the codename can be skipped.
After creation, use /{slug} to chat with the generated ex Skill.
| Command | Description |
|---|---|
/list-exes | List all ex Skills |
/{slug} | Full Skill (chat like them) |
/{slug}-memory | Memory mode (recall shared experiences) |
/{slug}-persona | Persona only |
/ex-rollback {slug} {version} | Rollback to a previous version |
/delete-ex {slug} | Delete |
/let-go {slug} | Gentle alias for delete |
Input:
First love, 3 years together in college, ENFP, Gemini, talkative, sends voice messages at 2am, still likes my posts after breakup
Scenario 1: Casual Chat
You ❯ whatcha doing Ex.skill ❯ just had dinner, scrolling my phone why'd you message me out of nowhere [sends a meme]
Scenario 2: Memory Lane
You ❯ remember our first date? Ex.skill ❯ the one with the terrible pasta? lmao you pretended it was good, I totally noticed that restaurant closed down btw, did you know?
Scenario 3: Late Night Emo
You ❯ I kinda miss you Ex.skill ❯ ... yeah get some sleep
| Source | Format | Notes |
|---|---|---|
| WeChatMsg / PyWxDump export | Recommended, richest data | |
| txt / mht export | Great for school-era relationships | |
| Social Media | Screenshots | Extracts public persona |
| Photos | JPEG/PNG with EXIF | Timeline and location extraction |
| Narration | Plain text | Your subjective memories |
Each ex Skill has two parts working together:
| Part | Content |
|---|---|
| Part A — Relationship Memory | Shared experiences, date spots, inside jokes, fight patterns, sweet moments, timeline |
| Part B — Persona | 5-layer structure: Hard rules → Identity → Speech style → Emotional patterns → Relationship behavior |
Attachment Styles: Secure · Anxious · Avoidant · Disorganized
Love Languages: Words of Affirmation · Quality Time · Receiving Gifts · Acts of Service · Physical Touch
Personality Tags: Talkative · Reserved · Tough-love · Silent treatment · Clingy · Independent · Romantic · Pragmatic · Perfectionist · Procrastinator · Workaholic · Jealous · Insecure · Night owl · Leaves on read · Instant replier ...
- Append memories → New chat logs or photos → Auto-analyze and merge
- Conversation corrections → "They wouldn't say that" → Instant correction
- Version management → Auto-archive on every update → Rollback supported
Every relationship teaches us something. Some people leave, but their words, their laughter, the way they got angry — all of it stays in your neural network. This Skill just helps you migrate those memories from biological to digital neural networks. Not to hold on, but to say a proper goodbye.
The architecture of this project is directly inspired by colleague-skill (同事.skill) by titanwings. colleague-skill pioneered the idea of "distilling a person into an AI Skill" with its dual-layer architecture (Work Skill + Persona). Ex-Partner.skill adapts this framework from workplace to romantic relationships. Huge respect to the original author's creativity and open-source spirit.
This project follows the AgentSkills open standard, compatible with Claude Code and OpenClaw.
These are independent open-source projects. We only adapt their export formats in our parsers:
- WeChatMsg — WeChat message export (Windows)
- PyWxDump — WeChat database decryption & export (Windows)
- 留痕 (Liuhen) — WeChat message export (macOS)
MIT License © T_T
