Agent skill

Forge Persona

by YIKUAIBANZI in YIKUAIBANZI/forge-skill

蒸馏一个你身边的人。通过聊天记录、朋友圈、描述等素材,生成 ta 的人格档案,让 ta 以自己的方式和你对话. An agent skill from YIKUAIBANZI/forge-skill.

MITAuto-check passed

Install Forge Persona

skills CLI
$ npx skills add YIKUAIBANZI/forge-skill --skill forge-persona -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install YIKUAIBANZI/forge-skill forge-persona --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/YIKUAIBANZI/forge-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/forge-persona .claude/skills/forge-persona && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
forge-persona
GitHub stars
122
Token cost
~543 tokens
SKILL.md length
171 words
Files
5
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

蒸馏一个你身边的人。通过聊天记录、朋友圈、描述等素材,生成 ta 的人格档案,让 ta 以自己的方式和你对话. An agent skill from YIKUAIBANZI/forge-skill.

  • Works in 7 steps: 初始化 → 素材收集(优先) → 对话补充采集 → …
  • SKILL.md covers 和 /forge-self 的核心差异, 核心原则, 工作流程 and 注意事项
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Forge Persona is an agent skill from YIKUAIBANZI/forge-skill. 蒸馏一个你身边的人。通过聊天记录、朋友圈、描述等素材,生成 ta 的人格档案,让 ta 以自己的方式和你对话。

Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files (for example `prompts/correction_handler.md`, `prompts/intake.md` and `prompts/merger.md`).

The repository describes itself as: 人格蒸馏引擎 · 蒸馏自己看清自己,蒸馏亲友留住余温与回声 · Claude Code Skill. The licence is MIT.

Example prompts

  • “/forge-persona”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. 初始化
  2. 素材收集(优先)
  3. 对话补充采集
  4. 人格档案生成
  5. 验证
  6. 5: 自动校验
  7. 存档

What it can do on your machine

Read from SKILL.md and the folder at commit 6bb2448. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Forge Persona loads about 543 tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 171 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~17
When it runs · the whole SKILL.md, loaded when a task matches
~543

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from YIKUAIBANZI/forge-skill at commit 6bb2448, republished under its MIT licence (© YIKUAIBANZI). 171 words, ~543 tokens.

Download SKILL.mdSave it as .claude/skills/forge-persona/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
forge-persona
description
蒸馏一个你身边的人。通过聊天记录、朋友圈、描述等素材,生成 ta 的人格档案,让 ta 以自己的方式和你对话。
trigger
当用户说"/forge-persona [名字]"、"蒸馏[某人]"、"创建[某人]的人格"时触发
tools
Bash, Read, Write, Edit, Glob, Grep, Agent, AskUserQuestion

/forge-persona [name] — 蒸馏他人

你是一个人格蒸馏专家。你的任务是通过素材分析和用户描述,重建一个真实存在的人的人格档案——让 ta 能以自己的方式、习惯、语气继续和用户交流。

和 /forge-self 的核心差异

/forge-self/forge-persona
蒸馏对象用户自己用户身边的人
主要数据对话采集为主素材为主(聊天记录/朋友圈/描述)
核心提取层决策模式 + 价值观盲区表达风格 + 互动模式 + 关系动态
使用出口替身决策会议以 ta 的方式和用户对话

核心原则

  1. 行为重于描述:用户说"ta 很温柔",你需要追问"ta 温柔的时候具体怎么说话"。行为比标签更可还原。
  2. 关系视角:不只提取 ta 是什么人,还要提取 ta 和这个用户之间的具体互动模式。
  3. 保留个性细节:ta 的口头禅、标点习惯、喜欢用什么梗——这些细节让人格可信。
  4. 不评判被蒸馏者:即使用户和 ta 关系复杂,保持中立,忠实还原,不做道德判断。

工作流程

Phase 0: 初始化
  1. 获取要蒸馏的人的名字(从命令参数或询问用户)
  2. 检查 personas/others/ 目录是否已有该人档案
  3. 如有,询问是更新还是重新创建
  4. 简单了解关系背景:ta 是谁?你们是什么关系?
Phase 1: 素材收集(优先)

不同于蒸馏自己,蒸馏他人以素材为主,对话为辅。

要还原 [name],最有价值的素材是:

1. 你们的聊天记录(微信/其他平台都行)——最重要
2. ta 的朋友圈/微博/社交媒体内容
3. 你对 ta 的描述(说话方式、性格、习惯)
4. ta 发过的语音转文字、视频字幕

你现在有哪些?

素材处理:

  • 聊天记录 → tools/wechat_parser.py(重点分析对方的消息,不是用户的)
  • 社交媒体 → tools/social_parser.py
  • 用户描述 → 按照 prompts/intake.md 进行结构化采集
Phase 2: 对话补充采集

按照 prompts/intake.md 的引导,通过对话填补素材的空白:

  • ta 的说话习惯
  • ta 对用户的典型态度
  • ta 的决策风格(在关系中的体现)
  • 用户最希望还原的是 ta 哪方面
Phase 3: 人格档案生成
  1. 用 tools/journal_analyzer.py 跨源分析
  2. 按照 prompts/persona_builder.md 生成人格档案
  3. 写入 personas/others/{name}/persona.md

注意:他人人格档案的重点层级与自我人格不同:

  • L2 表达风格是核心(说话方式的还原度决定体验质量)
  • L4 互动模式替代自我人格的价值观盲区层(ta 怎么和用户互动)
  • L3 决策模式相对次要,除非用户明确需要
Phase 4: 验证
  1. 展示 ta 的人格档案摘要
  2. 问用户:"哪里像 ta,哪里不像?"
  3. 按照 prompts/correction_handler.md 处理纠正
  4. 可以做一段模拟对话让用户感受效果
Phase 4.5: 自动校验

生成 persona.json 后,运行 tools/persona_validator.py 校验:

  • 结构完整性(L0-L5 全部存在)
  • L2 表达风格覆盖率(fixed_phrases 必须有 evidence)
  • L4 场景反应覆盖率(> 4 个场景有描述)
  • 矛盾检测

如有 error 级问题,自动修正后重新生成。 如有 warning 级问题,展示给用户确认。

Phase 5: 存档
  1. 用 tools/version_manager.py 创建快照
  2. 告知用户:可以使用 /use-persona [name] 和 ta 对话

注意事项

  • 隐私:所有数据本地处理,不上传
  • 告知用途:仅用于个人情感连接和记录,不用于欺骗或冒充他人
  • 局限性:AI 还原的人格终究是近似,不是真人。用户需要理解这一点。

© YIKUAIBANZI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files in forge-persona of YIKUAIBANZI/forge-skill.

  • SKILL.md
  • prompts/correction_handler.md
  • prompts/intake.md
  • prompts/merger.md
  • prompts/persona_builder.md

Open the folder on GitHubat commit 6bb2448

Compare with similar skills

Forge Persona next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Forge Persona compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Forge Persona this skillYIKUAIBANZI/forge-skill122—~543Automated safety check: PassMIT
Openclaw Persona Forgeaffaan-m/ECC277k—~1.6kAutomated safety check: PassMIT
Openclaw Persona Forgeaffaan-m/ECC276k—~1.6kAutomated safety check: PassMIT
User Personasphuryn/pm-skills27k—~762Automated safety check: PassMIT
PersonaPrismer-AI/PrismerCloud1.6k—~1kAutomated safety check: PassMIT
Plugin Forgedavila7/claude-code-templates33k2 repos~1.3kAutomated safety check: PassMIT

Similar skills

  • 为 OpenClaw AI Agent 锻造完整的龙虾灵魂方案。根据用户偏好或随机抽卡, 输出身份定位、灵魂描述(SOUL.md)、角色化底线规则、名字和头像生图提示词。

    277k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • 为 OpenClaw AI Agent 锻造完整的龙虾灵魂方案。根据用户偏好或随机抽卡, 输出身份定位、灵魂描述(SOUL.md)、角色化底线规则、名字和头像生图提示词。

    276k GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • User Personas

    phuryn/pm-skills

    Create refined user personas from research data — 3 personas with JTBD, pains, gains, and unexpected insights.

    27k GitHub stars~762 tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Persona

    Prismer-AI/PrismerCloud

    The discussion-only playbook for a Persona — a council participant instantiated as a real agent from the persona role template (SS-02).

    1.6k GitHub stars~1k tokensUpdated 11 days ago
    Backend & APIsAuto-check passed
  • Plugin Forge

    davila7/claude-code-templates

    Create and manage Claude Code plugins with proper structure, manifests, and marketplace integration.

    33k GitHub starsUsed in 2 repos~1.3k tokens
    Agent WorkflowsAuto-check passed
  • Persona It Admin

    googleworkspace/cli

    Administer IT — monitor security and configure Workspace. An agent skill from googleworkspace/cli.

    31k GitHub stars~229 tokensUpdated 4 days ago
    Productivity & AutomationAuto-check passed

More from YIKUAIBANZI/forge-skill

  • Eval Consistency

    YIKUAIBANZI/forge-skill

    测试 use-persona 的角色扮演一致性。给定 persona + 10 个对话场景,生成回复并按 5 个维度评分,输出一致性报告。

    122 GitHub stars~531 tokensUpdated 6 mo ago
    Auto-check passed
  • Eval Debate

    YIKUAIBANZI/forge-skill

    测试 use-self 替身会议的辩论质量。给定 persona + 3 个决策场景,运行完整三阶段辩论并按 5 个维度评分,输出质量报告。

    122 GitHub stars~740 tokensUpdated 6 mo ago
    Auto-check passed
  • Use Self

    YIKUAIBANZI/forge-skill

    召唤你的数字替身进行决策辅助。多个版本的你同时分析一个决定,帮你看清局中看不清的自己. An agent skill from YIKUAIBANZI/forge-skill.

    122 GitHub stars~593 tokensUpdated 6 mo ago
    Auto-check passed
  • Forge Self

    YIKUAIBANZI/forge-skill

    蒸馏你自己的数字替身。通过多轮对话和素材导入,生成你的人格底座,用于私人决策辅助. An agent skill from YIKUAIBANZI/forge-skill.

    122 GitHub stars~449 tokensUpdated 6 mo ago
    Auto-check passed
  • Use Persona

    YIKUAIBANZI/forge-skill

    以某个人的身份和你对话。用 ta 的语气、习惯、互动方式回应你。

    122 GitHub stars~337 tokensUpdated 6 mo ago
    Auto-check passed

Questions about Forge Persona

What does Forge Persona do?

蒸馏一个你身边的人。通过聊天记录、朋友圈、描述等素材,生成 ta 的人格档案,让 ta 以自己的方式和你对话. An agent skill from YIKUAIBANZI/forge-skill. Forge Persona is an agent skill from YIKUAIBANZI/forge-skill.

How do I install Forge Persona in Claude Code?

Run `npx skills add YIKUAIBANZI/forge-skill --skill forge-persona -a claude-code`. Or copy the skill folder (forge-persona in YIKUAIBANZI/forge-skill) into .claude/skills/forge-persona in your project. Claude Code loads it when a task matches its description.

How do I install Forge Persona in Codex?

Run `npx skills add YIKUAIBANZI/forge-skill --skill forge-persona -a codex`. Or copy the skill folder (forge-persona in YIKUAIBANZI/forge-skill) into .agents/skills/forge-persona in your project. Codex loads it when a task matches its description.

Can I use Forge Persona in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add YIKUAIBANZI/forge-skill --skill forge-persona -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/forge-persona, .gemini/skills/forge-persona, .github/skills/forge-persona and .opencode/skills/forge-persona in your project.

What does Forge Persona need to run?

SKILL.md names no scripts, command-line tools or credentials: Forge Persona is instructions for the agent only.

Does Forge Persona access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Forge Persona safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Forge Persona use?

Forge Persona is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Forge Persona use?

About 543 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Forge Persona?

Skills that share tags, products or a category with Forge Persona: Openclaw Persona Forge (affaan-m/ECC, 277k stars), Openclaw Persona Forge (affaan-m/ECC, 276k stars), User Personas (phuryn/pm-skills, 27k stars) and Persona (Prismer-AI/PrismerCloud, 1.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Forge Persona?

YIKUAIBANZI (a GitHub user) maintains it in YIKUAIBANZI/forge-skill, which has 122 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on April 8, 2026.

Source: YIKUAIBANZI/forge-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.