CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

story-setup

网文写作工具集基础设施部署与检查。为 Claude Code / OpenCode / Codex / Google Antigravity / ZCode / OpenClaw / Reasonix 提供内置适配;Web AI / 通用 Agent 可走 skills + AGENTS.md 文件模式。触发方式:/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」。

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Failed to scan

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 operational, well-sequenced deployment skill: fully specified commands, verbatim user prompts, explicit validation and failure handling for every risky step, and a clean one-level reference structure. The only defects are a few overly dense run-on passages and one dangling reference (UPGRADING.md) in the reference table.

Suggestions

Remove or fix the UPGRADING.md row in the 参考资料 table — that file is not present anywhere in the bundle, so readers following the table hit a missing document.

Break the long run-on paragraphs (the Phase 1 reference-directory self-check and the Phase 2 path-safety/symlink discussion) into labeled bullet lists so each rule (existence check, stop conditions, symlink cases) is individually scannable.

DimensionReasoningScore

Conciseness

The body is dense and operational throughout — no explanations of concepts Claude already knows and no filler — but several passages are long run-ons mixing multiple concerns (the Phase 1 reference-directory self-check paragraph and the Phase 2 source/target path-safety paragraph with its symlink discussion) that could be split or trimmed. Not 5 due to these tightenable passages; not 3 since nearly every token carries task-specific operational detail.

4 / 5

Actionability

Fully executable guidance: an exact sentinel field block with the `date -u +"%Y-%m-%dT%H:%M:%SZ"` command, a copy-paste `merge-project-instructions.py` invocation with every argument, the `python3` → `python` → `py` PYBIN detection order, verbatim AskUserQuestion wording, and enumerated marker files per host. Not 4: nothing is left as high-level hints or pseudocode.

5 / 5

Workflow Clarity

Phases 1–3 are clearly sequenced with an explicit validation phase, and risky batch copy operations are gated by `scripts/copy-path-safety.py` with enumerated JSON statuses and mandated stop conditions ("无法确认就停止,不得尝试复制"). Error recovery is specified: idempotent re-runs after interruption, version gates preventing downgrade, and pre-deploy cleanup of self-nested residue — matching the validate/fix/retry anchor.

5 / 5

Progressive Disclosure

The SKILL.md is an overview of the common flow with well-signaled, one-level-deep references (8 per-host deploy files, diagnostics.md, 7 scripts) and an explicit instruction to read only the target host's file ("只读本次目标宿主的那一份"); nearly all referenced paths exist in the bundle. Not 5 because the reference table cites `UPGRADING.md`, which does not exist anywhere in the bundle — a dangling reference; not 3 since the split and navigation are otherwise clean.

4 / 5

Total

18

/

20

Passed

Description

83%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 strong description with an explicit trigger clause, natural user phrases in the target language, and concrete enumeration of supported hosts and fallback mode. It loses a little on action-verb coverage and on a couple of trigger phrases with minor overlap risk.

DimensionReasoningScore

Specificity

The description states two concrete actions ("基础设施部署与检查" — deploy and inspect infrastructure) and enumerates seven named hosts with built-in adapters plus a concrete fallback ("skills + AGENTS.md 文件模式"), which goes beyond the 1-2-action anchor 3 example. It is not 5 because the verbs are limited to deploy/inspect and the deployed artifacts themselves (hooks, agents, commands) are not enumerated.

4 / 5

Completeness

It clearly answers 'what' (infrastructure deployment and inspection for a web-novel writing toolkit, with per-host adaptation) and 'when' via an explicit trigger clause ("触发方式:...") containing concrete trigger phrases — the exact pattern of the anchor-5 example. Not 4: the 'when' is not merely present but explicit with multiple concrete phrases.

5 / 5

Trigger Term Quality

It lists both command syntaxes ("/story-setup、$story-setup") and four natural phrases a user would actually say (「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」). Not 5 because common synonyms such as 安装/部署/初始化 variants are missing; not 3 since multiple natural user phrases plus command triggers far exceed 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (网文写作工具集, seven named platforms, /story-setup command) with mostly distinct triggers. Not 5 because 「帮我搭一下环境」 is fairly generic and could match non-writing environment-setup skills, and 「准备写书」 could overlap with the suite's own writing skills; not 3 since the domain and command triggers are far more specific than the anchor-3 example.

4 / 5

Total

17

/

20

Passed

Validation

75%

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

Validation — 12 / 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

referenced_paths_exist

Referenced path issues: 2 missing, 1 deeper-than-1-level

Warning

Total

12

/

16

Passed

Repository

zenstory-ai/oh-story-claudecode

Path

skills/story-setup/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.