Persona Voice Card Builder

What it does

When your agent uses it

• Turning a stable way of addressing you and speaking into a reusable persona card
• Forking a built-in persona into a variant with a different register
• Checking an existing persona card for schema, safety and differentiation problems
• Preparing a persona to submit to the community portal

Example prompts

• “Distill the voice we have been using this week into a persona card.”
• “Create a new persona from the built-in one, but with a terser register and no emoji.”
• “Validate config/personas/night-owl.json and tell me what fails.”

Requirements

• Node.js 18 or newer
• A persona card JSON file to validate, or a conversation to distill from
• Compatibility (from SKILL.md): node>=18
• Pre-approved tools (allowed-tools): Bash, Read, Write, Edit

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

1. 1schema 合规（结构性，机器判）：通过 persona-voice-card.schema.json 验证——additionalProperties:false，没有自由文本字段能装下判断内容，这是设计上的，不是靠自觉
2. 2无政治 / 宗教 / 民族敏感内容——会因平台审查阻断分发
3. 3无真实人名 / 商标盗用——法律红线
4. 4self / user 必须自然——非自然称谓（单个非中文符号）warn
5. 5不含判断性字段——schema 里根本没有 authorization / scenarios / priority 这类字段，validate 会直接拒绝任何试图塞入的未知字段

What it can do on your machine

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

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash
  • Read
  • Write
  • Edit

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/ (JavaScript), which the agent can run.

  Shell commands in SKILL.md call:

  • node

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

• Network

  Links to these hosts (documentation or services it may open):

  • telagod.github.io

  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.

• Compatibility

  node>=18

  From compatibility in the SKILL.md frontmatter.

Context cost

Persona Voice Card Builder loads about 716 tokens when it runs, and up to ~3.3k if it reads all its reference files. Until then it costs about 107 tokens; SKILL.md has 136 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~107

When it runs · the whole SKILL.md, loaded when a task matches

~716

With references · SKILL.md plus every file in references/, read only if the agent opens them

~3.3k

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

• NotePre-approves every shell command (allowed-tools: Bash)SKILL.md

  allowed-tools: Bash, Read, Write, Edit

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); the scripts in this folder are not scanned.

SKILL.md

The full file from telagod/code-abyss at commit 2544577, republished under its MIT licence (© telagod). 136 words, ~716 tokens.

name

cultivating-personas

description

Distills AI agent voice patterns from conversation into a Persona Voice Card v1.0 (self/user/language/register/emoji_policy/flourish only — no judgment-shaped fields), validates schema + content safety + differentiation, and routes contributions through the existing submission portal. Use when the user wants to crystallize a recurring voice/tone, fork an existing persona, or share one with the community.

allowed-tools

Bash, Read, Write, Edit

compatibility

node>=18

user-invocable

true

argument-hint

<distill|create|validate|publish> [persona-slug]

aliases

forge-persona, cultivate-persona

<!-- safety-scan: ignore TOOLS_PRIVILEGED 特权理由：Bash 用于 schema 校验脚本；Write/Edit 用于在用户确认后落盘 <slug>.json -->

# 校验现有 card
node scripts/persona_forge.js validate config/personas/<slug>.json

# 从会话提炼（交互式，不直接落盘，先输出预览）
node scripts/persona_forge.js distill --voice-hint "<观察笔记>"

# 生成提交 payload（给 submit.html 用）
node scripts/persona_forge.js publish config/personas/<slug>.json

© telagod, 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 5 other files (scripts, references) in skills/cultivating-personas of telagod/code-abyss.

• SKILL.md
• references/distillation.md
• references/persona-safety.md
• references/publishing.md
• references/voice-consistency.md
• scripts/persona_forge.js

Open the folder on GitHubat commit 2544577