CtrlK
BlogDocsLog inGet started
Tessl Logo

cs-doc-api

Deprecated 兼容入口:旧 cs-doc-api 调用用;转交 cs-docs --mode api。新请求不要主动选择。

56

Quality

63%

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 ./plugins/codestable/skills/cs-doc-api/SKILL.md
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.

The body is a well-organized, concise routing shim with a clear sequenced workflow and an explicit failure checkpoint, appropriately delegating detail to the authoritative cs-docs protocol. Its only gap is actionability: the 'load cs-docs' step lacks a concrete executable mechanism.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — a thin shim with brief rules and no padded explanations of concepts Claude already knows, matching the 'lean and efficient; every token earns its place' anchor.

3 / 3

Actionability

It gives specific instructions (load cs-docs by installed name, carry requested_mode: api, do not re-prompt the user) but provides no concrete executable command or mechanism for the 'load' step, fitting 'some concrete guidance but incomplete'.

2 / 3

Workflow Clarity

A clear four-step sequence includes an explicit stop-and-report checkpoint when the main protocol cannot load, providing a validation gate; for a simple, non-destructive skill this meets the level-3 anchor.

3 / 3

Progressive Disclosure

The content is short, well-sectioned (执行规则 / 维护规则), and delegates detail to cs-docs and its references rather than duplicating it, so a simple under-50-line skill with no nested references scores 3.

3 / 3

Total

11

/

12

Passed

Description

42%

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

The description clearly communicates a narrow deprecated-compatibility role and is highly distinct, but it relies on technical jargon rather than natural trigger terms and lacks an explicit 'Use when…' usage clause. It is adequate for a legacy entry but weak as discoverable trigger guidance.

Suggestions

Add a natural-language 'Use when…' trigger clause (e.g., when a caller still invokes the old cs-doc-api name) so users and Claude know when this entry should activate.

Replace skill-name/flag jargon with at least one phrase a user might naturally say, rather than only 'cs-doc-api' and '--mode api'.

Briefly state the concrete outcome of the forwarding (e.g., 'runs the cs-docs API workflow') to lift specificity beyond a single action.

DimensionReasoningScore

Specificity

Names a single concrete action ("转交 cs-docs --mode api") but does not list multiple specific capabilities, matching the 'names domain and some actions' anchor rather than the 'multiple specific concrete actions' level 3.

2 / 3

Completeness

It states what the entry does (forward to cs-docs) and a weak when (legacy calls; new requests should not select it), but lacks a clean 'Use when…' clause, so completeness is capped at 2 per the judging guideline.

2 / 3

Trigger Term Quality

The keywords are skill names and CLI flags ("cs-doc-api", "cs-docs --mode api") — technical jargon a user would not naturally say, fitting the 'no natural keywords; technical jargon' anchor.

1 / 3

Distinctiveness Conflict Risk

It describes a narrow, single-purpose deprecated shim for one specific skill with explicit non-use guidance for new requests, making it clearly distinguishable and unlikely to trigger for the wrong skill.

3 / 3

Total

8

/

12

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.