CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

story-short-write

短篇网文写作。辅助短篇小说创作,从构思到成稿,聚焦情绪拉扯与节奏把控。触发方式:/story-short-write、/写短篇、「帮我写一篇短篇」「写个盐言故事」。

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/story-short-write/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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.

An exceptionally actionable, well-gated workflow document: exact commands, explicit completion checklists, feedback loops, and a disciplined per-phase reference-loading scheme that matches a verified bundle structure. The main cost is token weight — inline agent-deployment/versioning plumbing and triple-stated gating rules could be pushed into the existing reference files without losing any safety property.

Suggestions

Move the cross-platform agent-directory table, ZCode 3.3.4 fallback rules, and agents_version: 36 mismatch messaging into references/agent-calls.md, keeping only a one-line pointer in SKILL.md.

State the '完整读取 until EOF, no rg/局部摘读' rule once in the 写前必读 section and reference it from Phase 2/3/4 instead of restating the gating in each phase and the 参考资料 footer.

Replace the repeated '写完前完整读取 X' phrasing with the phase table as the single source of truth for loading, cutting roughly 10-15 lines of duplicated gating text.

DimensionReasoningScore

Conciseness

Most of the body is dense, high-yield instruction (phase table, checklists, exact thresholds like 「超过 10 处需逐处复核」and the 8000-12000 default), but two things keep it below anchor 4: the blockquoted agent-deployment plumbing (cross-platform agent directories, ZCode 3.3.4, `.story-deployed` parsing, `agents_version: 36` mismatch messaging — inline version-number detail that the guidelines penalize unless placed in a deprecation/old-patterns section) and the repeated re-statement of the '完整读取' gating rules across the 写前必读 table, the Phase 2/3/4 sections, and the 参考资料 footer. It is not anchor 2 because there is no concept-explaining padding and nearly every other line carries instruction; it could be tightened by moving the agent/version mechanics into references/agent-calls.md, which already exists.

3 / 5

Actionability

The body provides copy-paste-ready commands with concrete expectations: `node scripts/check-ai-patterns.js --check --fail-on=blocking 正文.md`, `node scripts/check-degeneration.js --check 正文.md`, and the full `scripts/author_memory_commit.py query --workspace {工作区} --book-root {项目目录} --kind prose_style --kind story_design [--genre {题材}] [--workflow 短篇]` invocation, plus exact file names to write (设定.md, 小节大纲.md, 正文.md), a concrete emotion-to-genre mapping table, and even the literal question to ask the author. Per the scoring note for instruction-only skills, the absence of code is not penalized because the guidance is fully executable; this matches anchor 5.

5 / 5

Workflow Clarity

The four-phase process (定情绪 → 构思 → 写正文 → 精修) is explicitly sequenced with per-phase loading and file handoff, a Phase 3 completion checklist of seven concrete criteria, an explicit feedback loop ('不通过 → 回退补足,不得进入精修'), validation scripts with expected outcomes and error handling ('其余提示先通读,确属问题再改'), and hard stop conditions ('任一必需路径不存在…立即停止,不得创建或修改故事产物'). Validation is present and specific, so the destructive/batch cap does not apply; this matches anchor 5 (clear sequence, explicit validation, feedback loops, checklist).

5 / 5

Progressive Disclosure

Scored against the actual bundle: all paths referenced in the body (16 references, 10 genre-styles packs, 3 scripts) exist, SKILL.md is a genuine overview, the 写前必读 table gives per-phase load conditions, and references/reference-index.md is a clean one-level-deep index with per-file '何时加载' conditions and a same-topic routing line. This is good-to-excellent structure, but it sits at anchor 4 rather than 5 because the agent-spawn/version-check plumbing is inlined in the top-level file instead of the existing agent-calls.md reference, and the loading rules are specified redundantly in three places (首屏 table, phase sections, and references), leaving minor organization gaps.

4 / 5

Total

17

/

20

Passed

Description

70%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 solid description with an explicit trigger clause containing real user utterances and a clear domain, written in neutral voice. Its main weakness is that the capability statement is one general sentence — adding the concrete operations the skill actually performs (emotion selection, genre-specific design, reversal construction, revision and AI-flavor self-check) would lift specificity and completeness.

Suggestions

Expand the capability sentence to enumerate 3-4 concrete actions, e.g. '选定目标情绪、按题材设计反转与付费点、逐场景成稿、AI 味自检', so the 'what' is as concrete as the trigger clause.

Add 1-2 natural trigger synonyms such as '写个短篇小说' or other platform names users commonly mention, to broaden trigger coverage without adding fluff.

DimensionReasoningScore

Specificity

The description states '辅助短篇小说创作,从构思到成稿,聚焦情绪拉扯与节奏把控' — it names the domain (short-form web fiction), a pipeline span (conception to finished draft), and two focus areas (emotional tension, pacing), but '辅助…创作' is a generic assist verb and no concrete operations (emotion selection, reversal design, revision/de-slopping, self-check) are enumerated. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive); it is above anchor 2 because the conception-to-draft span and named focus areas go beyond bare domain naming, but below anchor 4 because no list of several specific actions is present. The description uses neutral (third-person-equivalent) voice, so no voice penalty applies.

3 / 5

Completeness

Both 'what' (assists short-story creation from conception to finished draft, focused on emotional tension and pacing) and 'when' (an explicit '触发方式' clause with concrete trigger phrases) are present, satisfying the explicit-trigger-guidance requirement. It sits between anchors 4 and 5: the 'when' is fully explicit with concrete phrases, but the 'what' is one general sentence rather than a list of concrete capabilities, so it does not clearly reach anchor 5's standard of explicitly answering 'what' with the same concreteness as the trigger side.

4 / 5

Trigger Term Quality

The '触发方式' clause gives two slash commands (/story-short-write, /写短篇) and two genuinely natural user utterances — 「帮我写一篇短篇」and 「写个盐言故事」(a named platform, 盐言故事). This is good keyword coverage with real user phrasing, matching anchor 4 ('PDF files, forms, document extraction' equivalent). It falls short of anchor 5 because common synonyms are missing: no '短篇小说/写小说' variants, no other platform names, and no mention of related intents like revising or continuing a short piece.

4 / 5

Distinctiveness Conflict Risk

The description carves a fairly clear niche (writing a short web-fiction piece end-to-end) and its triggers ('写个盐言故事', '/写短篇') are unlikely to fire for non-writing tasks, matching anchor 4 ('mostly distinct; minor overlap risk with closely related skills'). It is not a 5 because the body reveals sibling skills in the same family (/story-deslop, /story-long-write, /story-short-analyze) whose intents (revising, longer fiction, analysis) sit close to generic '写一篇短篇' phrasing, and the description does not explicitly bound itself against those neighbors.

4 / 5

Total

15

/

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-short-write/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.