FreePublished on GitHub

textum

Textum PRD→Scaffold→Story workflow for Codex with low-noise outputs and gate checks.

The English summary is being prepared. Showing the original description.

snakeying/Textum

See how to install

Files included (160)

SKILL.md2.9 KB
assets/prd-pack.schema.json14.5 KB
assets/prd-pack.template.json1.1 KB
assets/scaffold-pack.template.json498 B
assets/split-plan-pack.template.json379 B
references/prd-check.md607 B
references/prd-plan.md3.8 KB
references/prd-render.md682 B
references/prd-slice.md581 B
references/scaffold-check.md695 B
references/scaffold-plan.md2.8 KB
references/scaffold.md647 B
references/split-check1.md1.1 KB
references/split-check2.md812 B
references/split-checkout.md630 B
references/split-plan.md4.2 KB
references/split.md688 B
references/story-check.md719 B
references/story-full-exec.md1.8 KB
references/story-pack.md880 B
references/story.md2.3 KB
scripts/pyproject.toml334 B
scripts/pyrightconfig.json199 B
scripts/tests/__init__.py1 B
scripts/tests/test_next_routing.py1.4 KB
scripts/tests/test_prd_bundle_contract.py5.1 KB
scripts/tests/test_scaffold_bundle_contract.py4.9 KB
scripts/tests/test_split_bundle_contract.py12.6 KB
scripts/tests/test_story_bundle_contract.py4.6 KB
scripts/textum/__init__.py36 B
scripts/textum/prd/__init__.py26 B
scripts/textum/prd/prd_pack_ids.py6.2 KB
scripts/textum/prd/prd_pack_io.py2.4 KB
scripts/textum/prd/prd_pack_maps.py1.8 KB
scripts/textum/prd/prd_pack_paths.py2.1 KB
scripts/textum/prd/prd_pack_placeholders.py2.1 KB
scripts/textum/prd/prd_pack_types.py691 B
scripts/textum/prd/prd_pack_validate_access.py4.4 KB
scripts/textum/prd/prd_pack_validate_modules.py6.0 KB
scripts/textum/prd/prd_pack_validate_project.py2.3 KB
scripts/textum/prd/prd_pack_validate_refs.py3.6 KB
scripts/textum/prd/prd_pack_validate_rules_api.py2.9 KB
scripts/textum/prd/prd_pack_validate_utils.py6.9 KB
scripts/textum/prd/prd_pack_validate.py1.5 KB
scripts/textum/prd/prd_pack.py1.1 KB
scripts/textum/prd/prd_render_i18n_labels_en.py4.1 KB
scripts/textum/prd/prd_render_i18n_labels_zh.py4.2 KB
scripts/textum/prd/prd_render_i18n.py1.8 KB
scripts/textum/prd/prd_render_sections_1_4.py4.5 KB
scripts/textum/prd/prd_render_sections_10.py770 B
scripts/textum/prd/prd_render_sections_5_7.py5.5 KB
scripts/textum/prd/prd_render_sections_8_10.py493 B
scripts/textum/prd/prd_render_sections_8.py4.9 KB
scripts/textum/prd/prd_render_sections_9.py4.9 KB
scripts/textum/prd/prd_render_utils.py1.6 KB
scripts/textum/prd/prd_render.py3.7 KB
scripts/textum/prd/prd_slices_generate_write_a.py5.7 KB
scripts/textum/prd/prd_slices_generate_write_b.py2.5 KB
scripts/textum/prd/prd_slices_generate.py1.8 KB
scripts/textum/prd/prd_slices_types.py154 B
scripts/textum/prd/prd_slices_utils.py3.2 KB
scripts/textum/prd/prd_slices_writer.py3.7 KB
scripts/textum/prd/prd_slices.py183 B
scripts/textum/scaffold/__init__.py31 B
scripts/textum/scaffold/scaffold_pack_extract.py8.3 KB
scripts/textum/scaffold/scaffold_pack_io.py2.4 KB
scripts/textum/scaffold/scaffold_pack_placeholders.py3.2 KB
scripts/textum/scaffold/scaffold_pack_types.py188 B
scripts/textum/scaffold/scaffold_pack_validate_decisions.py6.6 KB
scripts/textum/scaffold/scaffold_pack_validate_extracted.py2.3 KB
scripts/textum/scaffold/scaffold_pack_validate_utils.py1.3 KB
scripts/textum/scaffold/scaffold_pack_validate.py1.6 KB
scripts/textum/scaffold/scaffold_pack.py2.7 KB
scripts/textum/scaffold/scaffold_render_emit.py3.7 KB
scripts/textum/scaffold/scaffold_render_extract.py6.9 KB
scripts/textum/scaffold/scaffold_render.py395 B
scripts/textum/split/__init__.py28 B
scripts/textum/split/split_check_index_generate.py5.6 KB
scripts/textum/split/split_check_index_io.py495 B
scripts/textum/split/split_check_index_pack.py246 B
scripts/textum/split/split_check_index_replan.py1.9 KB
scripts/textum/split/split_check_index_story_build.py1.3 KB
scripts/textum/split/split_check_index_story.py6.3 KB
scripts/textum/split/split_check_index_thresholds.py5.4 KB
scripts/textum/split/split_check_refs_prd.py2.5 KB
scripts/textum/split/split_check_refs_scaffold.py636 B
scripts/textum/split/split_check_refs_validate_against.py6.6 KB
scripts/textum/split/split_check_refs.py3.9 KB
scripts/textum/split/split_checkout_graph.py2.0 KB
scripts/textum/split/split_checkout_io.py1.5 KB
scripts/textum/split/split_checkout.py6.0 KB
scripts/textum/split/split_pack_io.py1.6 KB
scripts/textum/split/split_pack_placeholders.py3.1 KB
scripts/textum/split/split_pack_types.py476 B
scripts/textum/split/split_plan_pack_normalize.py2.7 KB
scripts/textum/split/split_plan_pack_validate_api.py5.8 KB
scripts/textum/split/split_plan_pack_validate_stories.py2.9 KB
scripts/textum/split/split_plan_pack_validate_story_row.py7.2 KB
scripts/textum/split/split_plan_pack_validate_utils.py1.7 KB
scripts/textum/split/split_plan_pack_validate.py3.6 KB
scripts/textum/split/split_plan_pack.py1.4 KB
scripts/textum/split/split_story_generate_plan.py4.2 KB
scripts/textum/split/split_story_generate_write.py5.3 KB
scripts/textum/split/split_story_generate.py2.3 KB
scripts/textum/split/split_story_landing.py3.9 KB
scripts/textum/split/split_story_paths.py827 B
scripts/textum/split/split_story_prd.py2.4 KB
scripts/textum/split/split_thresholds.py1.2 KB
scripts/textum/story/__init__.py28 B
scripts/textum/story/story_check_utils.py6.7 KB
scripts/textum/story/story_check_validate_details.py7.9 KB
scripts/textum/story/story_check_validate_external.py5.4 KB
scripts/textum/story/story_check_validate_internal.py1.4 KB
scripts/textum/story/story_check_validate_meta.py4.1 KB
scripts/textum/story/story_check_validate_refs.py1.1 KB
scripts/textum/story/story_check.py2.0 KB
scripts/textum/story/story_exec_pack_context.py2.3 KB
scripts/textum/story/story_exec_pack_snapshot.py1.3 KB
scripts/textum/story/story_exec_pack_utils.py686 B
scripts/textum/story/story_exec_pack_validate.py6.5 KB
scripts/textum/story/story_exec_pack_write_index.py2.0 KB
scripts/textum/story/story_exec_pack_write.py5.8 KB
scripts/textum/story/story_exec_pack.py6.5 KB
scripts/textum/story/story_exec_paths.py1.5 KB
scripts/textum/story/story_exec_types.py643 B
scripts/textum/textum_cli_artifacts.py4.5 KB
scripts/textum/textum_cli_emit.py562 B
scripts/textum/textum_cli_next.py1.9 KB
scripts/textum/textum_cli_prd_check.py2.0 KB
scripts/textum/textum_cli_prd_init.py897 B
scripts/textum/textum_cli_prd_patch.py7.0 KB
scripts/textum/textum_cli_prd_render.py1.4 KB
scripts/textum/textum_cli_prd_slice.py2.2 KB
scripts/textum/textum_cli_prd.py2.8 KB
scripts/textum/textum_cli_result.py494 B
scripts/textum/textum_cli_runner.py2.6 KB
scripts/textum/textum_cli_scaffold.py6.3 KB
scripts/textum/textum_cli_split_check1.py3.1 KB
scripts/textum/textum_cli_split_check2.py5.0 KB
scripts/textum/textum_cli_split_checkout_cli.py1.1 KB
scripts/textum/textum_cli_split_checks.py210 B
scripts/textum/textum_cli_split_generate.py3.9 KB
scripts/textum/textum_cli_split_plan_check.py6.7 KB
scripts/textum/textum_cli_split_plan_init.py1.4 KB
scripts/textum/textum_cli_split_plan.py161 B
scripts/textum/textum_cli_split.py3.9 KB
scripts/textum/textum_cli_story_check.py5.0 KB
scripts/textum/textum_cli_story_load.py1.5 KB
scripts/textum/textum_cli_story_pack.py7.4 KB
scripts/textum/textum_cli_story.py1.8 KB
scripts/textum/textum_cli_support.py6.1 KB
scripts/textum/textum_cli.py754 B
scripts/textum/textum_json_patch_append.py2.9 KB
scripts/textum/textum_json_patch_delete.py1.9 KB
scripts/textum/textum_json_patch_set.py2.6 KB
scripts/textum/textum_json_patch_utils.py711 B
scripts/textum/textum_json_patch.py241 B
scripts/textum/textum_json_path_parse.py1.8 KB
scripts/textum/textum_json_path.py290 B
scripts/uv.lock127 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Textum

Hard constraints:

Low-noise is non-negotiable (avoid attention/context pollution).
Multi-window: each stage is self-contained; do not narrate upstream/downstream flow.
Output “next step” as a stage name only.

Prereq (runtime):

uv installed.
Run uv sync --project .claude/skills/textum/scripts once (creates .claude/skills/textum/scripts/.venv).

Supported stages:

PRD Plan → references/prd-plan.md
PRD Check → references/prd-check.md
PRD Render → references/prd-render.md
PRD Slice → references/prd-slice.md
Scaffold Plan → references/scaffold-plan.md
Scaffold Render → references/scaffold.md
Scaffold Check → references/scaffold-check.md
Split Plan → references/split-plan.md
Split Generate → references/split.md
Split Check1 → references/split-check1.md
Split Check2 → references/split-check2.md
Split Checkout → references/split-checkout.md
Story Check → references/story-check.md
Story Pack → references/story-pack.md
Story Exec → references/story.md
Story Full Exec (experimental) → references/story-full-exec.md

Routing:

CN intent examples:
- PRD Plan: 需求澄清 / 澄清需求 / PRD 计划
- PRD Render: 生成PRD / 渲染PRD / 输出PRD
- PRD Check: 校验PRD / 检查PRD / 门禁
- PRD Slice: PRD 切片 / 切片 / 低噪切片 / slice
- Scaffold Plan: 上下文提取 / 全局上下文 / Scaffold 计划
- Scaffold Render: 生成GLOBAL-CONTEXT / 渲染GLOBAL-CONTEXT / 输出GLOBAL-CONTEXT
- Scaffold Check: 校验GLOBAL-CONTEXT / 检查GLOBAL-CONTEXT / GC 门禁
- Split Plan: Story 拆分规划 / Split Plan / 拆分计划
- Split Generate: 生成Story / Split Generate / 拆分生成
- Split Check1: Split 校验1 / 拆分校验1 / 结构阈值校验
- Split Check2: Split 校验2 / 拆分校验2 / 引用一致性校验
- Split Checkout: Split Checkout / 依赖图 / 导出依赖图
- Story Check: Story 校验 / Story Check / 单 Story 门禁
- Story Pack: Story 执行包生成 / Story Pack / 生成执行包
- Story Exec: Story 执行 / Story Exec / 单 Story 执行
- Story Full Exec: Story 批量执行 / Story Full Exec / 试验性全执行
If intent is unclear, ask the user to pick one: PRD Plan / PRD Check / PRD Render / PRD Slice / Scaffold Plan / Scaffold Render / Scaffold Check / Split Plan / Split Generate / Split Check1 / Split Check2 / Split Checkout / Story Check / Story Pack / Story Exec / Story Full Exec.

Always:

For every FAIL item (in diagnostics/replan packs): include loc/problem/expected/impact/fix, and fix must be a single action.
Keep chat output low-noise: prefer paths (wrote: docs/*) over pasting long FAIL lists.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Report a problem with this skill

Install

Install with a command

npx skills add https://github.com/snakeying/Textum --skill textum

Paste it into your terminal and run it (requires Node.js). You can choose which agents to install it for, such as Claude Code or Codex.

Ask your agent

Please install the following Agent Skill.
https://github.com/snakeying/Textum/tree/main/.claude/skills/textum

First review SKILL.md and the bundled files and confirm there is nothing suspicious (such as sending data externally or reading credentials). Then place it in ~/.claude/skills/textum/ for Claude Code, or ~/.agents/skills/textum/ for Codex.

Send this text to Claude Code or Codex as is. It checks the contents before installing.

View source on GitHub

Repository: snakeying/Textum
Stars: 41
Forks: 3
Category: Writing & Fiction
License: MIT
Original language: Chinese
Last updated: Jan 19, 2026

A skill is a set of instructions and scripts for an agent. cccskills does not guarantee that skills are safe. Review the contents before you install.