CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

story-long-analyze

长篇网文拆文。保留黄金三章、逐章摘要、剧情、情绪、节奏、角色、设定和文风接口,以连续章节块完成因果、双时间线、关系与三维节奏分析;兼容旧成果直接使用、按需增强和断点续跑。含可选三层灵感库管道(灵感库、跨书灵感聚合、更新灵感库)。触发方式:/story-long-analyze、/长篇拆文、「帮我拆这本书」「拆这本书」「分析黄金三章」「深度拆解」「完整拆解」或提供小说文本文件路径。

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tightly written orchestration overview for a complex multi-stage pipeline: excellent progressive disclosure via a load-by-moment table backed by real reference files, and strong workflow clarity with validation checkpoints and error-recovery loops. Weakest spots are version-pinned runtime-compat details inlined in the body and some script invocations whose argument syntax is deferred.

Suggestions

Move the agent-bundle version compatibility notes (ZCode 3.3.4 behavior, agents_version: 36 mismatch handling) into a short dedicated compatibility reference or a clearly labeled compat section, keeping the body free of version-pinned, time-sensitive detail.

Inline one fully-argumented example each for the manage_analysis_run.py plan/digest/commit subcommands in the body (or a compact command table), so the core pipeline operations are copy-paste ready without opening pipeline-ops.md.

Trim the legacy 情绪模块 migration exception (copy to _analysis_cache/legacy/, re-edit failed cards) down to a pointer into stage3-plot-rhythm.md, since it is a rare repair path that adds branching detail to the main Phase 2 table.

DimensionReasoningScore

Conciseness

The body is lean and telegraphic with no explanations of concepts Claude already knows, but the version-pinned compatibility block at the top ('ZCode 3.3.4 不提供项目 custom agents', 'agents_version: 36') is time-sensitive runtime detail that sits in the main body rather than a compat/deprecated section, and some operational rules (legacy 情绪模块 migration) could live in a reference. Efficient with minor trimming opportunities, matching anchor 4.

4 / 5

Actionability

It provides a fully executable command ('"{PYTHON}" "{skill 根}/scripts/inspect_existing_assets.py" --root "拆文库/{书名}" --compact'), exact file paths, and decision tables keyed on concrete checker codes (recommended_path, stage_repairs, invalid_topic_decision_contract). Not 5 because several script invocations (plan, digest, commit) are only named with their argument syntax deferred to reference files, leaving minor gaps.

4 / 5

Workflow Clarity

The multi-stage pipeline is clearly sequenced (按时刻读 load table, Phase 2 path table, Stage 0–6 with handoff markers per stage) and includes explicit validation and feedback loops: '路径错误必须停止', '落表前校验章号连续、无重复和边界有效', non-overwrite policy with cache-aware deletion rules, 'mark-stage --stage stage5 --prepare 备份旧报告' before rewriting, and script-stop → read index-rebuild.md → present options recovery. This matches anchor 5's checklist-and-recovery-loop standard for a complex batch workflow.

5 / 5

Progressive Disclosure

The body is a true overview: all 12 cited reference files exist in references/ with real content, and the 按时刻读 table tells the agent exactly which file to load at each stage with handoff state. References are one level deep (reference files link only to siblings while carrying their own content), matching anchor 5's well-signaled, easy-navigation structure.

5 / 5

Total

18

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A dense, highly specific description that explicitly covers both what the skill does and when to trigger it, with excellent natural-language trigger phrases. The only weakness is that unqualified phrases like「拆这本书」could collide with the sibling short-form analysis skill since no disambiguation is offered.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities and deliverables — '保留黄金三章、逐章摘要、剧情、情绪、节奏、角色、设定和文风接口,以连续章节块完成因果、双时间线、关系与三维节奏分析' plus resume/enhance modes and the optional inspiration pipeline — giving comprehensive, not minor-gap, coverage. It does not fall to 4 because no capability area named in the trigger guidance is left uncovered.

5 / 5

Completeness

It explicitly answers 'what' (detailed capability list including analysis types and compatibility modes) and 'when' via a dedicated '触发方式' clause with concrete trigger phrases. Not 4 because the 'when' is fully explicit with named triggers rather than merely present-but-improvable.

5 / 5

Trigger Term Quality

'触发方式:/story-long-analyze、/长篇拆文、「帮我拆这本书」「拆这本书」「分析黄金三章」「深度拆解」「完整拆解」或提供小说文本文件路径' covers slash commands, natural user phrases with synonyms, and a file-path trigger. Not 4 because natural variations users would actually say are comprehensively enumerated, not just 'a few missing'.

5 / 5

Distinctiveness Conflict Risk

The niche is clear (long-form web-novel deconstruction: '长篇网文拆文…长篇'), but generic phrases like「拆这本书」「深度拆解」 could also match the referenced sibling short-form skill (/story-short-analyze), and the description never scopes the short-form boundary. Mostly distinct with minor overlap risk with a closely related skill, matching anchor 4 rather than 5's 'minimal conflict risk'.

4 / 5

Total

19

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

zenstory-ai/oh-story-claudecode

Path

skills/story-long-analyze/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.