Agent skill

Novel Truncator

by VanGong1999 in VanGong1999/screen-creative-skills

“智能截断文本,保持内容完整性。适用于小说文本预处理、确保文本不超过指定长度限制”

— description from SKILL.md by VanGong1999
MITAuto-check passedWriting & Content

Install Novel Truncator

skills CLI
$ npx skills add VanGong1999/screen-creative-skills --skill novel-truncator -a claude-code

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

GitHub CLI
$ gh skill install VanGong1999/screen-creative-skills novel-truncator --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/VanGong1999/screen-creative-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/category/novel-screening/novel-truncator .claude/skills/novel-truncator && 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
novel-truncator
GitHub stars
446
Token cost
~458 tokens
SKILL.md length
55 words
Files
3 (incl. scripts, references)
Skills in repo
62
Repo updated
First seen
Licence
MIT

At a glance

  • Works in 3 steps: 优先句子结束: 在句号、问号、感叹号处断开。 → 其次段落结束: 在空格、换行符处断开。 → 最后指定长度: 确保不超过设定的最大长度限制。
  • SKILL.md covers 功能, 使用场景, 截断原则 and 输入要求, plus 5 more sections
  • Runs Python scripts from its folder

About this skill

Novel Truncator is a skill in VanGong1999/screen-creative-skills (446 stars). Its SKILL.md is about 458 tokens, with 2 other files in the folder (scripts, references). Licence: MIT.

Requirements

  • Compatibility (from SKILL.md): Claude Code 1.0+

Workflow steps

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

  1. 优先句子结束: 在句号、问号、感叹号处断开。
  2. 其次段落结束: 在空格、换行符处断开。
  3. 最后指定长度: 确保不超过设定的最大长度限制。

What it can do on your machine

Read from SKILL.md and the folder at commit 6ced54f. 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 1 file in scripts/ (Python), which the agent can run.

    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.

  • Compatibility

    Claude Code 1.0+

    From compatibility in the SKILL.md frontmatter.

Context cost

Novel Truncator loads about 458 tokens when it runs, and up to ~1.1k if it reads all its reference files. Until then it costs about 14 tokens; SKILL.md has 55 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~14
When it runs · the whole SKILL.md, loaded when a task matches
~458
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.1k

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

SKILL.md

The full file from VanGong1999/screen-creative-skills at commit 6ced54f, republished under its MIT licence (© VanGong1999). 55 words, ~458 tokens.

Download SKILL.mdSave it as .claude/skills/novel-truncator/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
novel-truncator
description
智能截断文本,保持内容完整性。适用于小说文本预处理、确保文本不超过指定长度限制
compatibility
Claude Code 1.0+
category
novel-screening
version
2.1.0
last_updated
2026-01-11
license
MIT
maintainer
宫凡
model
opus

文本截断工具(小说版)

功能

接收文本内容与最大长度限制,智能截断文本,保持内容完整性。

使用场景

  • 对长篇小说文本进行预处理,使其符合长度限制。
  • 在不破坏语义完整性的前提下,截取文本片段。
  • 确保输入到其他智能体的文本不超过其处理能力。

截断原则

  1. 优先句子结束: 在句号、问号、感叹号处断开。
  2. 其次段落结束: 在空格、换行符处断开。
  3. 最后指定长度: 确保不超过设定的最大长度限制。

输入要求

  • 文本内容: 待截断的原始文本(字符串)。
  • 最大长度限制: 目标文本的最大字符数(整数)。
  • 截断标记(可选): 用于标识文本截断位置的字符串,如 "[...]"。

输出格式

【文本截断报告】

原始长度:[字符数]
截断后长度:[字符数]
截断位置:[位置描述,如:在第 X 句句号处]

截断后的文本:
[文本内容]

约束条件

  • 截断过程应最大限度地保留原文的语义和语境完整性。
  • 严格遵守最大长度限制。
  • 避免在词语中间进行截断。

示例

参见 {baseDir}/references/examples.md 目录获取更多详细示例:

  • examples.md - 包含不同截断场景(如按句子、按段落、强制截断)的详细示例。

详细文档

参见 {baseDir}/references/examples.md 获取关于文本截断工具的详细指导与案例。


版本历史

版本日期变更
2.1.02026-01-11优化 description 字段,使其更精简并符合命令式语言规范;优化功能、使用场景、截断原则、输入要求、输出格式的描述,使其更符合命令式语言规范;添加约束条件、示例和详细文档部分;模型更改为 opus。
2.0.02026-01-11按官方规范重构
1.0.02026-01-10初始版本

© VanGong1999, 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 2 other files (scripts, references) in category/novel-screening/novel-truncator of VanGong1999/screen-creative-skills.

  • SKILL.md
  • references/examples.md
  • scripts/novel_truncator.py

Open the folder on GitHubat commit 6ced54f

Compare with similar skills

Novel Truncator 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.

Novel Truncator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Novel Truncator this skillVanGong1999/screen-creative-skills446—~458Automated safety check: PassMIT
Story Multi-Perspective Reviewzenstory-ai/oh-story-claudecode7.4k3 repos~3kAutomated safety check: PassMIT
Short Web Fiction Trend Scanzenstory-ai/oh-story-claudecode7.4k2 repos~1.2kAutomated safety check: PassMIT
InkOS Creative HarnessNarcooo/inkos10k1 repos~1.1kAutomated safety check: PassAGPL-3.0
Novel Arteternityspring/shuohao-skills4.3k—~1.1kAutomated safety check: NotesApache-2.0
SepiaNanako0129/sepia3.1k—~3.6kAutomated safety check: PassMIT

Similar skills

  • Story Multi-Perspective Review

    zenstory-ai/oh-story-claudecode

    Reviews Chinese web-novel text with several reviewer agents in parallel, falling back to a single-agent pass, and reports structure, character, prose and setting problems with fixes.

    7.4k GitHub starsUsed in 3 repos~3k tokens
    Writing & ContentAuto-check passed
  • Short Web Fiction Trend Scan

    zenstory-ai/oh-story-claudecode

    Scans popular short web-fiction rankings on Chinese platforms such as Dianzhong and Heiyan to surface trending emotional hooks, themes and topic candidates with an expiry warning.

    7.4k GitHub starsUsed in 2 repos~1.2k tokens
    Writing & ContentAuto-check passed
  • Drives long-form fiction, scripts, storyboards, interactive films and long-document translation through InkOS, with every change made by a typed action.

    10k GitHub starsUsed in 1 repo~1.1k tokens
    Writing & ContentAuto-check passed
  • Novel Art

    eternityspring/shuohao-skills

    给 AI 短剧出美术设定集(场景 + 叙事道具):场景的设计意图、一致性锚点、光照时段变体、 空景提示词;道具的戏剧功能、状态变体、尺度参照、白底无手提示词。

    4.3k GitHub stars~1.1k tokensUpdated 2 days ago
    Writing & ContentAuto-check: notes
  • Sepia

    Nanako0129/sepia

    Make AI-generated writing read as human-written, in fiction and in professional prose.

    3.1k GitHub stars~3.6k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Story Toolbox Router

    zenstory-ai/oh-story-claudecode

    Routes a Chinese web-novel writing request to the matching tool in a 13-skill toolbox, covers author habit memory, and can launch a local dashboard for browsing a project.

    7.4k GitHub stars~1.7k tokensUpdated today
    Writing & ContentAuto-check passed

More from VanGong1999/screen-creative-skills

All 62 skills in this repo
  • Drama Creator

    VanGong1999/screen-creative-skills

    Create vertical short drama scripts covering macro construction, episode writing, precise optimization, and creative ideation using Emotional Spring Theory.

    446 GitHub stars~2.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Drama Workflow

    VanGong1999/screen-creative-skills

    Orchestrate the full plot-point dramatic function analysis pipeline — text preprocessing, parallel segment analysis, result integration, and report generation — for long-form story content.

    446 GitHub stars~850 tokensUpdated 4 mo ago
    Auto-check passed
  • Novel Evaluator

    VanGong1999/screen-creative-skills

    Evaluate and score story text across market potential, innovation attributes, and content highlights dimensions, producing structured scoring reports with development recommendations.

    446 GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check passed
  • Script Evaluator

    VanGong1999/screen-creative-skills

    Evaluate film and TV scripts across ideological, artistic, and entertainment value dimensions, producing structured scoring reports with follow-up recommendations.

    446 GitHub stars~1.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Story Five Elements

    VanGong1999/screen-creative-skills

    Analyze five core story elements — genre type, story summary, character biographies, character relationships, and major plot points — producing a structured comprehensive report with optional mind…

    446 GitHub stars~781 tokensUpdated 4 mo ago
    Auto-check passed
  • Character Profile

    VanGong1999/screen-creative-skills

    基于故事文本分析人物特征,生成详细的人物小传。适用于深度理解故事人物设定、为演员塑造角色提供参考、为剧本创作建立人物档案

    446 GitHub stars~609 tokensUpdated 4 mo ago
    Auto-check passed

Questions about Novel Truncator

How do I install Novel Truncator in Claude Code?

Run `npx skills add VanGong1999/screen-creative-skills --skill novel-truncator -a claude-code`. Or copy the skill folder (category/novel-screening/novel-truncator in VanGong1999/screen-creative-skills) into .claude/skills/novel-truncator in your project. Claude Code loads it when a task matches its description.

How do I install Novel Truncator in Codex?

Run `npx skills add VanGong1999/screen-creative-skills --skill novel-truncator -a codex`. Or copy the skill folder (category/novel-screening/novel-truncator in VanGong1999/screen-creative-skills) into .agents/skills/novel-truncator in your project. Codex loads it when a task matches its description.

Can I use Novel Truncator 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 VanGong1999/screen-creative-skills --skill novel-truncator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/novel-truncator, .gemini/skills/novel-truncator, .github/skills/novel-truncator and .opencode/skills/novel-truncator in your project.

What does Novel Truncator need to run?

Going by SKILL.md and its folder, Novel Truncator needs Python for the scripts in its folder. Compatibility (from SKILL.md): Claude Code 1.0+.

Does Novel Truncator 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 Novel Truncator 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Novel Truncator use?

Novel Truncator is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Novel Truncator use?

About 458 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 672 tokens, read only when the agent opens those files.

What are the alternatives to Novel Truncator?

Skills that share tags, products or a category with Novel Truncator: Story Multi-Perspective Review (zenstory-ai/oh-story-claudecode, 7.4k stars), Short Web Fiction Trend Scan (zenstory-ai/oh-story-claudecode, 7.4k stars), InkOS Creative Harness (Narcooo/inkos, 10k stars) and Novel Art (eternityspring/shuohao-skills, 4.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Novel Truncator?

VanGong1999 (a GitHub user) maintains it in VanGong1999/screen-creative-skills, which has 446 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on May 26, 2026.

Source: VanGong1999/screen-creative-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.