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

90%

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 unusually rigorous deployment skill: the orchestration body stays lean by delegating host detail to per-host reference files, provides fully executable commands, and wraps destructive batch operations in extensive validation gates and recovery paths. The main issues are a dangling UPGRADING.md reference and a few run-on paragraphs that would benefit from restructuring.

Suggestions

Remove the UPGRADING.md row from the reference table or ship the file — it is referenced but absent from the bundle, so following it fails.

Break the Phase 1 self-check paragraph and the .story-deployed target_cli rules into short bullet lists; each currently packs 5+ conditional rules into one run-on sentence.

The host list (claude-code, opencode, codex, antigravity, zcode, openclaw, reasonix, generic) is enumerated three times (step 5 markers, step 6 answers, sentinel target_cli); state it once and reference it.

DimensionReasoningScore

Conciseness

The body is densely packed with project-specific operational detail and assumes Claude's competence (no explanations of basic concepts), but several oversized paragraphs — the Phase 1 self-check paragraph and the sentinel target_cli rules — cram many rules into single run-on sentences and repeat the host enumeration, and could be split or tightened. This is efficient with minor trimming opportunities, not score-5 lean.

4 / 5

Actionability

Guidance is fully executable: exact file and directory names to verify, a copy-paste sentinel field block with `date -u +"%Y-%m-%dT%H:%M:%SZ"`, the complete `merge-project-instructions.py` command with every flag and placeholder defined, the interpreter probe order (python3 → python → py), and numbered manual-merge fallback rules.

5 / 5

Workflow Clarity

The three-phase sequence is explicit with strong validation checkpoints: pre-deploy bundle self-check with a hard stop, version gates that stop to avoid downgrade, copy-path-safety realpath/samefile checks before every recursive copy, per-host validation sections, Phase 3 sentinel verification, and an idempotent re-run-from-start recovery path for interruptions. Despite destructive/batch operations (pruning, overwriting managed files), validation and feedback loops are thoroughly specified.

5 / 5

Progressive Disclosure

The SKILL.md is a well-structured orchestration overview that delegates all host-specific detail to eight one-level-deep references/deploy-*.md files (all present) with an explicit "read only the target host's file" instruction, and every referenced script and templates/hooks/lib/sentinel.sh exists. However, UPGRADING.md is cited in the reference table but is missing from the bundle, a dangling reference that prevents a top score.

4 / 5

Total

18

/

20

Passed

Description

95%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: it states concrete capabilities, names its supported hosts, and gives an explicit trigger clause with both command forms and natural user phrasings. The only weakness is that the deployed artifacts themselves (hooks, agents, config files) are left implicit, which slightly limits specificity.

DimensionReasoningScore

Specificity

The description names the domain and several concrete capabilities — "基础设施部署与检查" (deployment and checking), "提供内置适配" for 7 named CLIs, and a "skills + AGENTS.md 文件模式" fallback for generic agents. It stops short of score 5 because it never states what artifacts are actually deployed (hooks, agents, config), leaving a coverage gap.

4 / 5

Completeness

It explicitly answers both "what" (deploy and check the web-novel writing toolset infrastructure, with per-host adaptation modes) and "when" via a dedicated 触发方式 (trigger) clause listing concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

"触发方式:/story-setup、$story-setup、「准备写书」「帮我搭一下环境」「配置写作项目」「检查写作环境」" covers both command forms and four natural phrases a user would actually say, spanning setup, configuration, and checking with synonym-level coverage.

5 / 5

Distinctiveness Conflict Risk

The niche is highly specific (web-novel writing toolset infrastructure for seven named CLIs plus a generic file mode) with distinct triggers like /story-setup, so the risk of firing for an unrelated skill is minimal.

5 / 5

Total

19

/

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.