CtrlK
BlogDocsLog inGet started
Tessl Logo

docs-workflows

Documentation and extension workflows derived from local slash commands (docs, explanation, issues, prototypes, tutorials, MCP design review).

55

Quality

61%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/docs-workflows/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%

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, lean router that correctly delegates detail to existing one-level reference files. Its weakness is that the in-body execution guidance is abstract and does not explicitly map each use-case trigger to the specific reference file to load.

Suggestions

Add a trigger-to-reference mapping table (e.g. "draft an issue → references/issue.md", "explain changes → references/explanation.md") so template selection is unambiguous.

Tighten the execution rules with one concrete in-body example of applying a template's required fields as an output contract.

For template-driven outputs, add a light verification step (e.g. confirm all required template fields are present before finalizing).

DimensionReasoningScore

Conciseness

The body is lean: a one-line overview, a short trigger list, a flat file index, four terse execution rules, and a single pointer. It assumes Claude's competence and does not pad with concepts Claude already knows, matching "lean and efficient; every token earns its place." It avoids the verbosity of the score-1 anchor.

3 / 3

Actionability

It points concretely to named reference files ("Read the relevant command template from this skill's references/") but the execution rules themselves are abstract ("Apply the template structure and required fields as the output contract") with no per-task detail in-body, matching "some concrete guidance but incomplete; missing key details." It is not a 1 because it does name specific files, and not a 3 because no in-body example or field specification is given.

2 / 3

Workflow Clarity

The four-step execution sequence is present (read template → apply structure → keep minimal → prefer clarity) but it is high-level and does not map each "When to use" trigger to a specific reference file, leaving template selection implicit. This matches "steps listed but checkpoints missing or implicit" rather than the fully sequenced, validated anchor at 3.

2 / 3

Progressive Disclosure

The body is an overview/router pointing to one-level-deep reference files (the "Source of truth" list and "Command mapping" pointer to command-catalog.md), all of which exist in ./references/. Content is appropriately split and navigation is clear, matching "clear overview with well-signaled one-level-deep references."

3 / 3

Total

10

/

12

Passed

Description

50%

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 names a clear domain and a useful set of work areas, but it relies on category labels rather than concrete actions and provides no explicit "Use when..." trigger clause. It is competent but mid-tier on every dimension.

Suggestions

Rewrite as concrete actions, e.g. "Draft and standardize docs, produce structured explanations, draft issues, outline prototypes, add tutorial entries, and run MCP design reviews."

Add an explicit trigger clause: "Use when the user asks to create documentation, draft an issue, explain changes, plan a prototype, add a tutorial, or review MCP design."

Include common keyword variations ("documentation", "article/video tutorial", "skill/command templates") so natural user phrasings match.

DimensionReasoningScore

Specificity

The phrase "Documentation and extension workflows derived from local slash commands (docs, explanation, issues, prototypes, tutorials, MCP design review)" names the domain and several work areas, but lists categories rather than concrete actions (no verbs like "draft", "standardize", "review"), matching the anchor that names a domain and some actions but is not comprehensive. It is not a 1 because it is far more specific than "Helps with documents", and not a 3 because it does not enumerate multiple specific concrete actions.

2 / 3

Completeness

It states what the skill does ("Documentation and extension workflows derived from local slash commands") but contains no "Use when..." clause or equivalent explicit trigger guidance; the "when" is only implied by the parenthetical categories. Per the judging guidelines, a missing explicit trigger clause caps completeness at 2.

2 / 3

Trigger Term Quality

The parenthetical "docs, explanation, issues, prototypes, tutorials, MCP design review" supplies several relevant natural keywords, but it omits common variations a user might say (e.g. "documentation", "article/video tutorial", "skill/command templates") that the body later claims as capabilities. This matches "some relevant keywords but missing common variations" rather than full coverage (3).

2 / 3

Distinctiveness Conflict Risk

"Documentation and extension workflows" with an "MCP design review" component gives it a somewhat specific niche, but the broad documentation framing could overlap with other doc-oriented skills, matching "somewhat specific but could still overlap with similar skills." It is not generic enough for 1, but lacks the sharply distinct single-domain triggers needed for 3.

2 / 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
TencentCloudBase/CloudBase-AI-Toolkit
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.