Files
2026-07-13 12:30:10 +08:00

5.2 KiB
Raw Permalink Blame History

ex.skill

"Every goodbye deserves a gentle place to rest."

Distill your ex into an AI Skill — let them live on in your terminal.

License: MIT Python 3.9+ Claude Code AgentSkills

 

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 · 中文


Installation

Claude Code

# Install to current project
mkdir -p .claude/skills
git clone https://github.com/therealXiaomanChu/ex-skill .claude/skills/create-ex

# Or install globally
git clone https://github.com/therealXiaomanChu/ex-skill ~/.claude/skills/create-ex

Dependencies (optional)

pip3 install -r requirements.txt

Usage

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.

Commands

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

Examples

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

Features

Data Sources

Source Format Notes
WeChat txt / html / json / csv exports Recommended, richest data
QQ 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

Generated Skill Structure

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

Supported Tags

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 ...

Evolution

  • 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

Philosophy

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.


Acknowledgments

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.


MIT License © therealXiaomanChu