CtrlK
BlogDocsLog inGet started
Tessl Logo

cs-docs-neat

CodeStable 文档收尾。触发:阶段结束、整理文档、同步记忆、/sync、/neat;做全局知识库卫生检查与四层同步。不要用于写单篇开发者/用户指南或 API 参考(cs-docs)、修 bug(cs-issue)、实现功能(cs-feat)、仓库初始化(cs-onboard)。

71

Quality

87%

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%

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

A well-structured, highly actionable phased workflow with strong validation checkpoints and clean one-level-deep reference files. The main weakness is moderate verbosity from motivational framing that does not add operational value.

Suggestions

Trim the motivational rationale in 启动必读 ("你是知识库编辑...代码可以重写,但文档和记忆是跨会话、跨 agent 的桥梁") down to a single line of intent, keeping only operational guidance.

Consider moving the large worked-example tables in Phase 1/Phase 2 into a reference file to reduce SKILL.md length while keeping the phases as concise checklists.

DimensionReasoningScore

Conciseness

The body is dense and information-rich, but includes motivational/justification prose (e.g. "你是知识库编辑,不是记录员...代码可以重写,但文档和记忆是跨会话的桥梁") that Claude does not strictly need; mostly efficient but could be tightened, so it sits at 2 rather than the lean 3.

2 / 3

Actionability

It provides concrete executable commands (wc -l, find, ls, rg with exact globs), specific numeric thresholds (300行/15KB, MEMORY.md ≤ 200行/25KB), exact file lists, and copy-ready tables, fully meeting the executable-guidance bar.

3 / 3

Workflow Clarity

A clear Phase 0–5 sequence with an explicit Phase 4 self-check checklist and a feedback loop ("SelfCheck 不过就回 Edit 修完重查") plus checkpoint/resolution handling, giving clear sequencing with explicit validation steps and error-recovery loops.

3 / 3

Progressive Disclosure

SKILL.md is an overview that points to two real one-level-deep bundle files (references/sync-matrix.md, references/agent-paths.md), each clearly signaled in the body and verified to exist, with content appropriately split rather than nested.

3 / 3

Total

11

/

12

Passed

Description

90%

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 compact, third-person description that clearly answers both what it does and when to trigger it, with strong distinctiveness via explicit sibling-skill exclusions. Slightly held back on specificity because the named actions are abstract rather than granularly concrete.

DimensionReasoningScore

Specificity

Names the domain and several actions ("文档收尾", "全局知识库卫生检查与四层同步", "同步记忆"), but the verbs stay at an abstract conceptual level rather than listing concrete granular actions, so it does not reach the multiple-specific-concrete-actions bar of 3.

2 / 3

Completeness

It states what the skill does (文档收尾 / 全局知识库卫生检查与四层同步) and gives an explicit "触发:..." clause for when to use it, plus a negative-use clause, so both what and when are explicitly answered.

3 / 3

Trigger Term Quality

Explicit trigger list "阶段结束、整理文档、同步记忆、/sync、/neat" covers natural phrasings a user would say plus slash-command invocations, giving good coverage of natural terms.

3 / 3

Distinctiveness Conflict Risk

The "不要用于写单篇...指南(cs-docs)、修 bug(cs-issue)、实现功能(cs-feat)、仓库初始化(cs-onboard)" clause carves out a clear niche and explicitly separates it from sibling skills, making wrong-skill triggering unlikely.

3 / 3

Total

11

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
codestable/CodeStable
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.