World Book Skill

What it does

When your agent uses it

• Tasks that involve Forms and validation

Example prompts

• “/world-book-skill”

Requirements

• Python 3

Workflow steps

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

1. 1非商业红线 — 本技能仅服务于开源社区的免费 RolePlay 创作。禁止为收费平台、商业代写、付费 API 服务生成角色卡或世界书。
2. 2原创与二创分流 — 原创走 Plan 模式交互式提问；二创走 information-extraction-guide.md 提取流程。两者不可混用。
3. 3角色卡 description 为空 — description 字段不写任何内容。角色全部信息（基本档案、外貌、背景、关系、性格）均放入世界书条目。
4. 4世界观设计先于世界书条目化 — 先读 world-building-guide.md 做概念设计，再读 world-book-guide.md 做条目落地。两个阶段不混淆。
5. 5先有设定，再写角色卡 — 角色卡编写在世界书条目完成后执行。设定不定稿，不写开场白。
6. 6不主动建议 MVU/EJS/HTML — 用户未提及上述功能时，绝不主动提议。EJS 依赖 MVU，用户要求 EJS 必须先确认 MVU 已启用。
7. 7禁词红线贯穿全程 — 收尾阶段强制执行 writing-optimization-guide.md，逐条扫描所有产出物。
8. 8物品写作分类规范 — 服装：写外观和材质，不写优点缺点。特殊道具：写外形和玩法，不写精确尺寸。
9. 9先读 reference，再动手 — 不凭记忆编写，每个任务类型必须读取其对应的全部 reference 文件后方可执行。任何写入操作之前必须先读 references/card-generator-guide.md，使用…

What it can do on your machine

Read from SKILL.md and the folder at commit e8501ea. 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

  Ships 3 files in scripts/ (Python), which the agent can run.

  Shell commands in SKILL.md call:

  • python

  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

World Book Skill loads about 1.8k tokens when it runs, and up to ~57k if it reads all its reference files. Until then it costs about 83 tokens; SKILL.md has 481 words of instructions outside code blocks.

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

~83

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

~1.8k

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

~57k

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 481 words (~1,787 tokens).

name

world-book-skill

Read the full SKILL.md on GitHub

Files

SKILL.md and 17 other files (scripts, references) in world-book-skill of echo-xianyu/worldbook-skill.

• SKILL.md
• agents/openai.yaml
• references/card-generator-guide.md
• references/character-card-guide.md
• references/character-guide.md
• references/config-guide.md
• references/ejs-guide.md
• references/guide.md
• references/html-beautify-guide.md
• references/information-extraction-guide.md
• references/mvu-guide.md
• references/position-guide.md
• references/world-book-guide.md
• references/world-building-guide.md
• references/writing-optimization-guide.md
• scripts/card-generator.py
• scripts/query.py
• scripts/world-book-create.py

Open the folder on GitHubat commit e8501ea