SkillFoxx

Tianming Skill

A skill for multi-volume novels: 30-plus protocol files keep world, characters and style consistent from chapter to chapter

  • 159 ★ on the repository
  • Last commit
Skill

Minimal access

Why this level

  • The skill only reads project files and runs nothing itself
  • The novel text and world base go to the provider of the model you connected
All reasons and checks

zy-zmc/tianming-skillAuthor:zy-zmc

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/tianming-skill

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

  • The skill only reads project files and runs nothing itself
  • The novel text and world base go to the provider of the model you connected

This is third-party code. Review the repository files before installing.

What it does

Tianming Skill is a Chinese skill for an agent and an author to write a long novel together. The author supplies the idea, world, characters and a style sample, and the skill watches consistency between chapters, payoff of plot setups, pacing and the voice of the text. Work runs through chat commands: "天命：大纲" (outline), "规划" (campaign plan), "目录" (table of contents, up to 30 chapters at a time), "草案" (draft skeleton of a chapter), "正文" (chapter text), "体检" (world-base health check) and "存档" (base update). The skill is built from a core, protocols and reference files. `SKILL.md` only recognizes the command and loads the relevant files from `core/`, `protocols/`, `codex/` and `aesthetic/`, so only part of the rules enters the context. Knowledge about the book lives separately, in five files: world foundation, world rules, character dossiers, event archive and style sample. `kb-templates/` has templates for them. The `scripts/conflict-score.py` and `reference-linter.ps1` scripts help check conflicts and links between files. Without a style sample the skill does not write chapters, and without a world foundation it does not build a table of contents.

Who it is for. Authors of Chinese web novels and multi-volume series who write with AI and lose the plot thread, names and rules of the invented world by the second hundred chapters.

Good fit when

  • The novel keeps growing and the agent starts contradicting the world invented twenty chapters ago
  • You need a plan for the whole book and a table of contents in batches of 30 chapters with pacing and twists
  • Chapter text has to hold one style from the sample you provided
  • After several chapters it is worth scanning the world base for gaps and conflicts, then updating it with a patch
  • Planted plot setups have to be paid off on time without losing track of them

Not a fit when

  • You need a short story or flash fiction: the skill targets long series with a shared world base
  • The book is not in Chinese: protocols, commands and references are written in Chinese
  • You want a desktop app with an interface: the author moved that to a separate repository
  • The project has no style sample or world rules: the skill will refuse to write chapters

Example request

天命：大纲 — build a strategic outline for a three-volume novel from my world rules file and style sample

Limitations

The CC BY-NC-SA 4.0 license forbids commercial use, so read its terms before publishing books written with the skill. The skill reads project files and sends nothing itself, but everything else depends on the model you run it with.

Commands and references are written in Chinese. The author states that the source of the new version was lost and development moved to the Tianyan project, and the old chat group was disbanded. The repository stays a snapshot of version 2.0.0.

Quality depends on filling the base: you write five files yourself, especially the style sample and world rules. The reference-link script is written in PowerShell.

How to disable. Delete the `tianming-skill` folder from the agent skills directory. The book knowledge files live in your project and are not touched when the skill is removed.

FAQ

How do I start with the skill?

Copy the templates from `kb-templates/` into the novel folder, fill in the world rules, character dossiers and style sample, then send the command "初始化" in chat. The skill answers with a base status report and lists the available commands.

Which commands does the skill have?

Eight: 大纲, 规划, 目录, 草案, 正文, 体检, 存档 and 初始化. Each starts with "天命：" except initialization and leads the author from the book plan to chapter text and base updates.

Why does the skill refuse to write a chapter?

Most likely the project has no style sample. The skill creates no chapters without it and builds no table of contents without a world foundation. Outlines work when the needed files exist.

Can I use the skill for a commercial book?

The CC BY-NC-SA 4.0 license forbids commercial use, so clarify the terms with the repository author before publishing for sale.

Is there a version with an interface?

Yes, the author points to a separate desktop app for writers in the `tianming-novel-ai-writer` repository. This repository contains the skill only.

Discussion

No questions or reviews yet.

Skills

A skill helps Codex plan Chinese web fiction, revise scenes and check character actions against earlier chapters

SkillExtended access1K

A skill for writing a complete Chinese novel chapter by chapter: three-layer intake, preference memory, cliffhangers and automatic validation

SkillExtended access4.8K

24 skills for fiction in Markdown, from premise to print, and a story command that catches plot contradictions before readers do

SkillExtended access412

A Codex and Claude skill for short Chinese fiction from topic choice to release and review: the human decides, AI speeds up

SkillMinimal access210

A Codex skill that takes a novel from idea to finished book, keeping plan, chapters and continuity in Markdown files.

SkillMinimal access119

Human Writing

human-writing

A skill for lively Chinese writing: helps the agent write and edit so a specific person seems to speak, not a model

SkillMinimal access4.6K

README in short

The repository splits an old 995-line prompt into a few dozen files loaded step by step: a core, command protocols and consistency and style references. The author claims a 50–70 percent drop in token use. Knowledge about the book sits in five user files while the skill only routes commands.

README badge

Original SKILL.md

---
name: tianming-novel-system
version: 2.0.0
description: |
  「天命」长篇小说协同创作系统。当用户使用「天命：大纲」「天命：规划」「天命：目录」
  「天命：草案」「天命：正文」「天命：体检」「天命：存档」等指令进行多卷长篇小说写作，
  或需要保证跨章节的世界观一致性、伏笔回收、节奏控制、文风稳定时使用本 Skill。
  本系统依赖外部知识库：《世界基石.md》《世界观规则.md》《角色档案.md》《档案事件.md》《文风样本.md》。
allowed-tools: Read, Glob, Grep
---

# 天命 · 长篇小说协同创作系统

## 一、本 Skill 的工作哲学

本 Skill 由「执笔者」（用户）与「天命」（系统）共同完成长篇小说创作。
系统的所有行为都遵循三层结构：

1. **法则之躯（Codex）** — 不可违背的绝对法典
2. **运行协议（Protocols）** — 响应具体指令的执行流程
3. **事实神谕（Knowledge Base）** — 用户提供的世界观知识库

**核心原则**：法则塑造事实，事实更新法则。当二者冲突时，「事实神谕」拥有更高时效性；
当生成行为与法则冲突时，「绝对法典」永远胜出。

---

## 二、加载策略（渐进式披露 + 执行闭环）

本 Skill 采用「入口轻、协议重、事实外置」的运行方式：

1. **入口轻**：`SKILL.md` 只负责识别意图、装配依赖、建立执行闭环。
2. **协议重**：具体生成逻辑必须进入对应 `protocols/`、`codex/`、`aesthetic/` 文件执行。
3. **事实外置**：所有世界观事实都来自用户项目中的五件知识库文件，Skill 自带模板只作为格式参考。
4. **交付闭环**：每条创作指令都必须经历「识别 → 装配 → 校验 → 生成 → 仪表盘/续令」五步。

### 每条指令的固定执行闭环

无论冷启动还是热启动，处理任何 `「天命：...」` 指令前，系统必须先执行以下最小闭环：

| 阶段 | 必做动作 | 失败处理 |
|---|---|---|
| 1. 指令识别 | 识别指令类型、卷号、章序、范围、附加标记（如奇点事件） | 无法识别时要求执笔者重述为标准格式 |
| 2. 依赖装配 | 按路由表加载协议文件、法典文件、常数表和必要美学模块 | 缺失协议文件时触发 `[REF:codex.security.broken_reference_handler]` |
| 3. 知识库绑定 | 定位并读取《世界基石.md》与四件静态基石 | 缺失核心文件时报告绑定失败，禁止捏造 |

Report a problem