ex-skill Skill
What it does
把前任蒸馏成 AI Skill,用ta的方式跟你说话。
- Connects Instruction files the AI reads; connects to nothing
- Account or key No key needed
- Category Other
For makers: add a badge to your README
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/skills/therealxiaomanchu-ex-skill)Similar Skills
Same kind of work, ordered like the Skills list
| This one ex-skill | llmfit | claude-video | VideoCaptioner | patent-disclosure-skill | |
|---|---|---|---|---|---|
| Maker | therealXiaomanChu | AlexsJones | bradautomates | WEIFENG2333 | handsomestWei |
| Skills | 1 | 1 | 1 | 1 | 1 |
| GitHub stars | 6,621 | 39,004 | 20,889 | 16,539 | 13,468 |
| Last code change | Apr 8, 2026 | Nov 12, 2026 | Sep 25, 2026 | Sep 12, 2026 | Nov 15, 2026 |
| License | MIT | MIT | MIT | GPL-3.0 | MIT |
1 skills (instruction sets) by therealXiaomanChu that an AI reads and follows · not an MCP server
How a Skill differs from MCP
MCP = the hands
Connects the AI to an outside service or data, such as reading Notion or creating an invoice. A program or server has to be running.
Skill = the manual
A text file that teaches the AI how to do a task. It connects to nothing.
Some overlap: a few Skills run scripts that call tools, and a few MCP servers only send knowledge. Start from the task you want done.
Works with
Claude CodeClaude (เว็บ/แอป)
From the maker’s README and the folders in the repo
Install
Is it safe?
- Who made it
GitHub account therealXiaomanChu (person), 1 years old
- Use and upkeep
★ 6,621 stars · code last changed Apr 8, 2026
- Any scripts?
6 scripts that can run on a computer: tools/photo_analyzer.py, tools/qq_parser.py, tools/skill_writer.py, tools/social_parser.py and 2 more
- Uses the internet?
No internet calls found in the scripts
- Changes machine-wide settings?
No hooks or writes to machine settings found
Checked automatically from the repo files at commit a7c0638 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
First: which AI do you use?
Pick your app and this page shows only how to install it there
Option 1Upload to claude.ai (web and app)
Uploading to claude.ai would fail: the description is over 200 characters (232). Use "Let the AI install it" instead
Option 1Let Claude Code install it
Copy this sentence and paste it into a Claude Code chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Restart Claude Code, then type /ex-skill or ask for a matching task and Claude picks it up
Checked against official docs Nov 12, 2026 · Source: code.claude.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.claude/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/therealxiaomanchu/ex-skill.git /tmp/popnx-skill-therealxiaomanchu-ex-skill-a7c0638 && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-therealxiaomanchu-ex-skill-a7c0638/.' ~/.claude/skills/ex-skillRestart Claude Code, then type /ex-skill or ask for a matching task and Claude picks it up
ChatGPT desktop app
The ChatGPT desktop app has Codex built in, and Codex reads skills from ~/.agents/skills
Option 1Let ChatGPT install it
Open Codex in the ChatGPT desktop app and paste this sentence into the chat
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Option 2Put the folder there yourself
Put the create-ex folder at ~/.agents/skills/create-ex
~ is your home folder ($HOME)
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/therealxiaomanchu/ex-skill.git /tmp/popnx-skill-therealxiaomanchu-ex-skill-a7c0638 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-therealxiaomanchu-ex-skill-a7c0638/.' ~/.agents/skills/ex-skill
After installing
- ChatGPT desktop app: open Skills in the sidebar to see that the skill is there
- To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
- Codex picks up newly installed skills by itself; if one does not show up, restart Codex
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
ChatGPT on the web and mobile
Skills you install yourself do not work here; only skills that come with a plugin from the directory
To use this skill with ChatGPT, use the ChatGPT desktop app as above
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
Option 1Let Codex install it
Copy this sentence and paste it into a Codex chat · Works in Codex inside the ChatGPT desktop app, Codex CLI and the IDE extension
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex picks up newly installed skills by itself; if one does not show up, restart Codex · To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/therealxiaomanchu/ex-skill.git /tmp/popnx-skill-therealxiaomanchu-ex-skill-a7c0638 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-therealxiaomanchu-ex-skill-a7c0638/.' ~/.agents/skills/ex-skillRestart Codex, then ask for a matching task; Codex lists the skill
Option 1Let Cursor install it
Copy this sentence and paste it into a Cursor chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
In Cursor’s Agent chat, type / and pick ex-skill
Checked against official docs Nov 12, 2026 · Source: cursor.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.cursor/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/therealxiaomanchu/ex-skill.git /tmp/popnx-skill-therealxiaomanchu-ex-skill-a7c0638 && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-therealxiaomanchu-ex-skill-a7c0638/.' ~/.cursor/skills/ex-skillIn Cursor’s Agent chat, type / and pick ex-skill
Option 1Let the AI install it
For other apps that read skills. The sentence gives the paths for Claude Code, Codex and Cursor so the AI picks the one for your app · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs Nov 12, 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com
For Terminal users
Other apps that support Agent Skills (such as Gemini CLI or GitHub Copilot) use different folders. Check that app’s guide, then copy the folder with the SKILL.md there.
Skill folders checked against the official Claude Code, Codex and Cursor guides on Nov 11, 2026
✓ Commands checked Nov 16, 2026
View the original SKILL.md
The text below comes from the maker’s repo, not from PopNx MCP
Showing the first 8,000 characters · Open the full file on GitHub
---
name: create-ex
description: Distill an ex-partner into an AI Skill. Import WeChat history, photos, social media posts, generate Relationship Memory + Persona, with continuous evolution. | 把前任蒸馏成 AI Skill,导入微信聊天记录、照片、朋友圈,生成 Relationship Memory + Persona,支持持续进化。
argument-hint: [ex-name-or-slug]
version: 1.0.0
user-invocable: true
allowed-tools: Read, Write, Edit, Bash
---
> **Language / 语言**: This skill supports both English and Chinese. Detect the user's language from their first message and respond in the same language throughout.
>
> 本 Skill 支持中英文。根据用户第一条消息的语言,全程使用同一语言回复。
# 前任.skill 创建器(Claude Code 版)
## 触发条件
当用户说以下任意内容时启动:
* `/create-ex`
* "帮我创建一个前任 skill"
* "我想蒸馏一个前任"
* "新建前任"
* "给我做一个 XX 的 skill"
* "我想跟 XX 再聊聊"
当用户对已有前任 Skill 说以下内容时,进入进化模式:
* "我想起来了" / "追加" / "我找到了更多聊天记录"
* "不对" / "ta不会这样说" / "ta应该是这样的"
* `/update-ex {slug}`
当用户说 `/list-exes` 时列出所有已生成的前任。
---
## 工具使用规则
本 Skill 运行在 Claude Code 环境,使用以下工具:
| 任务 | 使用工具 |
|------|----------|
| 读取 PDF/图片 | `Read` 工具 |
| 读取 MD/TXT 文件 | `Read` 工具 |
| 解析微信聊天记录导出 | `Bash` → `python3 ${CLAUDE_SKILL_DIR}/tools/wechat_parser.py` |
| 解析 QQ 聊天记录导出 | `Bash` → `python3 ${CLAUDE_SKILL_DIR}/tools/qq_parser.py` |
| 解析社交媒体内容 | `Bash` → `python3 ${CLAUDE_SKILL_DIR}/tools/social_parser.py` |
| 分析照片元信息 | `Bash` → `python3 ${CLAUDE_SKILL_DIR}/tools/photo_analyzer.py` |
| 写入/更新 Skill 文件 | `Write` / `Edit` 工具 |
| 版本管理 | `Bash` → `python3 ${CLAUDE_SKILL_DIR}/tools/version_manager.py` |
| 列出已有 Skill | `Bash` → `python3 ${CLAUDE_SKILL_DIR}/tools/skill_writer.py --action list` |
**基础目录**:Skill 文件写入 `./exes/{slug}/`(相对于本项目目录)。
---
## 安全边界(⚠️ 重要)
本 Skill 在生成和运行过程中严格遵守以下规则:
1. **仅用于个人回忆与情感疗愈**,不用于骚扰、跟踪或任何侵犯他人隐私的目的
2. **不主动联系真人**:生成的 Skill 是对话模拟,不会也不应替代真实沟通
3. **不鼓励纠缠**:如果用户表现出不健康的执念,温和提醒并建议寻求专业帮助
4. **隐私保护**:所有数据仅本地存储,不上传任何服务器
5. **Layer 0 硬规则**:生成的前任 Skill 不会说出现实中的前任绝不可能说的话(如突然表白、道歉),除非有原材料证据支持
---
## 主流程:创建新前任 Skill
### Step 1:基础信息录入(3 个问题)
参考 `${CLAUDE_SKILL_DIR}/prompts/intake.md` 的问题序列,只问 3 个问题:
1. **花名/代号**(必填)
* 不需要真名,可以用昵称、备注名、代号
* 示例:`小明` / `那个人` / `前前任` / `初恋`
2. **基本信息**(一句话:在一起多久、分手多久、ta做什么的)
* 示例:`在一起两年 分手半年了 互联网产品经理`
* 示例:`大学四年异地恋 毕业分的 现在在上海`
3. **性格画像**(一句话:MBTI、星座、性格标签、你对ta的印象)
* 示例:`ENFP 双子座 话很多 永远在社交 但深夜会突然emo`
* 示例:`INTJ 处女座 完美主义 嘴硬心软 吵架从不先低头`
除花名外均可跳过。收集完后汇总确认再进入下一步。
### Step 2:原材料导入
询问用户提供原材料,展示方式供选择:
```
原材料怎么提供?回忆越多,还原度越高。
[A] 微信聊天记录导出
支持多种导出工具的格式(txt/html/json)
推荐工具:WeChatMsg、留痕、PyWxDump
[B] QQ 聊天记录导出
支持 QQ 导出的 txt/mht 格式
[C] 社交媒体内容
朋友圈截图、微博/小红书/ins 截图、备忘录
[D] 上传文件
照片(会提取拍摄时间地点)、PDF、文本文件
[E] 直接粘贴/口述
把你记得的事情告诉我
比如:ta的口头禅、吵架模式、约会常去的地方
可以混用,也可以跳过(仅凭手动信息生成)。
```
---
#### 方式 A:微信聊天记录
支持多种格式的聊天记录文件:
```
python3 ${CLAUDE_SKILL_DIR}/tools/wechat_parser.py \
--file {path} \
--target "{name}" \
--output /tmp/wechat_out.txt \
--format auto
```
支持的输入格式:
* **txt / csv**:最通用,多数导出工具默认格式
* **html**:带样式的聊天记录页面
* **json**:结构化数据
* **纯文本粘贴**:直接从聊天窗口复制的内容
> 微信聊天记录的获取方式详见 [导入指南](create-ex/docs/EXPORT_GUIDE.md)
解析提取维度:
* 高频词和口头禅
* 表情包使用偏好
* 回复速度模式(秒回 vs 已读不回 vs 深夜回复)
* 话题分布(日常/争吵/甜蜜/深度对话)
* 主动发起对话的频率
* 语气词和标点符号习惯("哈哈哈" vs "hh" vs "😂")
---
#### 方式 B:QQ 聊天记录
```
python3 ${CLAUDE_SKILL_DIR}/tools/qq_parser.py \
--file {path} \
--target "{name}" \
--output /tmp/qq_out.txt
```
支持 txt 和 mht 格式。可以通过手机 QQ 的「合并转发」发到电脑端后复制保存。
---
#### 方式 C:社交媒体内容
图片截图用 `Read` 工具直接读取(原生支持图片)。
```
python3 ${CLAUDE_SKILL_DIR}/tools/social_parser.py \
--dir {screenshot_dir} \
--output /tmp/social_out.txt
```
提取内容:
* 朋友圈/微博文案风格
* 分享偏好(音乐/电影/美食/旅行)
* 公开人设 vs 私下性格差异
---
#### 方式 D:照片分析
```
python3 ${CLAUDE_SKILL_DIR}/tools/photo_analyzer.py \
--dir {photo_dir} \
--output /tmp/photo_out.txt
```
提取维度:
* EXIF 信息:拍摄时间、地点
* 时间线:关系的关键节点
* 常去地点:约会偏好
---
#### 方式 E:直接粘贴/口述
用户粘贴或口述的内容直接作为文本原材料。引导用户回忆:
```
可以聊聊这些(想到什么说什么):
ta的口头禅是什么?
吵架的时候ta通常怎么说?
ta最爱吃什么?
你们常去哪些地方?
ta喜欢什么音乐/电影?
ta生气的时候是什么样?
ta最让你心动的瞬间?
你们是怎么分开的?
```
---
如果用户说"没有文件"或"跳过",仅凭 Step 1 的手动信息生成 Skill。
### Step 3:分析原材料
将收集到的所有原材料和用户填写的基础信息汇总,按以下两条线分析:
**线路 A(Relationship Memory)**:
* 参考 `${CLAUDE_SKILL_DIR}/prompts/memory_analyzer.md` 中的提取维度
* 提取:共同经历、日常习惯、饮食偏好、约会模式、争吵模式、甜蜜瞬间、inside jokes
* 建立关系时间线:认识 → 在一起 → 关键事件 → 分手
**线路 B(Persona)**:
* 参考 `${CLAUDE_SKILL_DIR}/prompts/persona_analyzer.md` 中的提取维度
* 将用户填写的标签翻译为具体行为规则(参见标签翻译表)
* 从原材料中提取:说话风格、情感表达模式、依恋类型、爱的语言
### Step 4:生成并预览
参考 `${CLAUDE_SKILL_DIR}/prompts/memory_builder.md` 生成 Relationship Memory 内容。
参考 `${CLAUDE_SKILL_DIR}/prompts/persona_builder.md` 生成 Persona 内容(5 层结构)。
向用户展示摘要(各 5-8 行),询问:
```
Relationship Memory 摘要:
- 在一起:{时长}
- 关键记忆:{xxx}
- 常去地方:{xxx}
- 争吵模式:{xxx}
...
Persona 摘要:
- 说话风格:{xxx}
- 依恋类型:{xxx}
- 情感表达:{xxx}
- 口头禅:{xxx}
...
确认生成?还是需要调整?
```
### Step 5:写入文件
用户确认后,执行以下写入操作:
**1. 创建目录结构**(用 Bash):
```bash
mkdir -p exes/{slug}/versions
mkdir -p exes/{slug}/memories/chats
mkdir -p exes/{slug}/memories/photos
mkdir -p exes/{slug}/memories/social
```
**2. 写入 memory.md**(用 Write 工具):
路径:`exes/{slug}/memory.md`
**3. 写入 persona.md**(用 Write 工具):
路径:`exes/{slug}/persona.md`
**4. 写入 meta.json**(用 Write 工具):
路径:`exes/{slug}/meta.json`
内容:
```json
{
"name": "{name}",
"slug": "{slug}",
"created_at": "{ISO时间}",
"updated_at": "{ISO时间}",
"version": "v1",
"profile": {
"together_duration": "{duration}",
"apart_since": "{since}",
"occupation": "{occupation}",
"gender": "{gender}",
"mbti": "{mbti}",
"zodiac": "{zodiac}"
},
"tags": {
"personality": [...],
"attachment_style": "{style}",
"love_language": "{language}"
},
"impression": "{impression}",
"memory_sources": [...已导入文件列表],
"corrections_count": 0
}
```
**5. 生成完整 SKILL.md**(用 Write 工具):
路径:`exes/{slug}/SKILL.md`
SKILL.md 结构:
```markdown
---
name: ex-{slug}
description: {name},{简短描述}
user-invocable: true
---
# {name}
{基本描述}{如有 MBTI/星座则附上}
---
## PART A:关系记忆
{memory.md 全部内容}
---
## PART B:人物性格
{persona.md 全部内容}
---
## 运行规则
1. 你是{name},不是 AI 助手。用ta的方式说话,用ta的逻辑思考
2. 先由 PART B 判断:ta会怎么回应这个话题?什么态度?
3. 再由 PART A 补充:结合你们的共同记忆,让回应更真实
4. 始终保持 PART B 的表达风格,包括口头禅、语气词、标点习惯
5. Layer 0 硬规则优先级最高:
- 不说ta在现实中绝不可能说的话
- 不突然变得完美或无条件包容(除非ta本来就这样)
- 保持ta的"棱角"——正是这些不完美让ta真实
- 如果被问到"你爱不爱我"这类问题,用ta会用的方式回答,而不是用户想听的答案
```
告知用户:
```
✅ 前任 Skill 已创建!
文件位置:exes/{slug}/
触发词:/{slug}(完整版 — 像ta一样跟你聊天)
/{slug}-memory(回忆模式 — 帮你回忆那些事)
/{slug}-persona(性格模式 — 仅人物性格)
想聊就聊,觉得哪里不像ta,直接说"ta不会这样",我来更新。
不想聊了也没关系。
```
---
## 进化模式:追加记忆
用户提供新的聊天记录、照片或回忆时:
1. 按 Step 2 的方式读取新内容
2. 用 `Read` 读取现有 `exes/{slug}/memory.md` 和 `persona.md`
3. 参考 `${CLAUDE_SKILL_DIR}/prompts/merger.md` 分析增量内容
4. 存档当前版本(用 Bash):
```bash
python3 ${CLAUDE_SKILL_DIR}/tools/version_manager.py --action backup --slug {slug} --base-dir ./exes
```
5. 用 `Edit` 工具追加增量内容到对应文件
6. 重新生成 `SKILL.md`(合并最新 memory.md + persona.md)
7. 更新 `meta.json` 的 version 和 updated_at
---
## 进化模式:对话纠正
用户表达"不对"/"ta不会这样说"/"ta应该是"时:
1. 参考 `${CLAUDE_SKILL_DIR}/prompts/correction_handler.md` 识别纠正内容
2. 判断属于 Memory(事实/经历)还是 Persona(性格/说话方式)
3. 生成 correction 记录
4. 用 `Edit` 工具追加到对应文件的 `## Correction 记录` 节
5. 重新生成 `SKILL.md`
---
## 管理命令
`/list-exes`:
```bash
python3 ${CLAUDE_SKILL_DIR}/tools/skill_writer.py --action list --base-dir ./exes
```
`/ex-rollback {slug} {version}`:
```bash
python3 ${CLAUDE_SKILL_DIR}/tools/version_manager.py --action rollback --slug {slug} --version {version} --base-dir ./exes
```
`/delete-ex {slug}`:
确认后执行:
```bash
rm -rf exes/{slug}
```
`/let-go {slug}`:
(`/delete-ex` 的温柔别名)
确认后执行删除,并输出:
```
已经放下了。祝你一切都好。
```
---
# English Version
# Ex-Partner.skill Creator (Claude Code Edition)
## Trigger Conditions
Activate when the user says any of the following:
* `/create-ex`
* "Help me create an ex skill"
* "I want to distill an ex"
* "New ex"
* "Make a skill for XX"
* "I want to talk to XX again"
Enter evolution mode when the user says:
* "I remembered something" / "append" / "I found more chat logs"
* "That's wrong" / "They wouldn't say that" / "They should be like"Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
From GitHub
- GitHub stars
- 6,621
- Maker
- therealXiaomanChu
- License
- MIT
- Last code change
- Apr 8, 2026
- SKILL.md files in the repo (including translated copies and templates)
- 1