CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

docs-workflows

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

Quality

65%

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

68%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.

A well-disciplined delegating skill: a short overview body, real one-level-deep reference files, and repo-specific rules that only the repo could teach (doc/ vs specs/ handling). The main weaknesses are the absence of any output-validation checkpoint in the execution workflow, duplication between the Source-of-truth list and the command catalog, and one orphaned reference file.

Suggestions

Add a validation step to Execution rules, e.g. 'Before finishing, verify the output includes every required field defined in the template' — this directly lifts workflow_clarity past level 3.

Reference `references/source-commands.md` from the body (or note what it is for) so the 20KB file is not an unreachable orphan in the bundle.

Collapse the 'Source of truth' bullet list into the command catalog (or vice versa) so the same 11 file paths are not maintained in two places.

DimensionReasoningScore

Conciseness

The 46-line body is lean and assumes Claude's competence — no concept explanations, no filler — and lines like the `doc/` vs `specs/` commit rule add genuinely non-obvious repo knowledge. It falls short of 5 because the 11-file 'Source of truth' bullet list substantially duplicates the per-command file mapping in `references/command-catalog.md` and could be collapsed into a single pointer.

4 / 5

Actionability

For an instruction-only skill the guidance is concrete: it names the exact reference file to read, defines the output contract ('apply the template structure and required fields'), and gives specific repo locations (`doc/`, `specs/`, `AGENTS.md` section `<internal_dirs>`). Minor gaps keep it below 5 — no guidance on picking a template when a request matches multiple commands, and 'Command mapping' delegates wholesale to `command-catalog.md` rather than giving one inline example.

4 / 5

Workflow Clarity

Execution rules give a usable sequence (read template → apply structure → keep edits minimal/locations), and the 'never commit specs/' warning is a real guardrail, but there is no validation checkpoint — nothing like 'confirm the output contains every required field from the template before finishing'. That matches 'steps listed but validation gaps' rather than level 4's 'most checkpoints present'.

3 / 5

Progressive Disclosure

Scored against the actual bundle: every referenced path in the body exists in `references/`, references are one level deep and clearly signaled under 'Source of truth', and the body is a genuine overview rather than a wall of text. Two minor gaps hold it at 4: `references/source-commands.md` (20KB) is an orphan — never referenced or navigable from the body — and reaching a template via 'Command mapping' requires a double hop (body → command-catalog.md → reference file).

4 / 5

Total

15

/

20

Passed

Description

45%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.

The description correctly identifies the domain and enumerates the covered sub-areas, but it is a category listing rather than a capability statement: no concrete actions, no 'Use when' trigger clause, and few natural user phrasings. It reads as moderately informative but under-specifies both what the skill does and when to reach for it.

Suggestions

Replace the passive framing with concrete action verbs, e.g. 'Creates and standardizes documentation, drafts issues, produces structured explanations, plans prototypes, adds article/video tutorial entries, and runs MCP design reviews, derived from the repo's local slash commands.'

Add an explicit trigger clause, e.g. 'Use when the user asks to write or standardize docs, draft an issue, explain changes, outline a prototype, add a tutorial entry, or add an AI IDE/skill/command template.'

Include natural synonyms users would actually say — 'article', 'video tutorial', 'spec', 'AI IDE', 'add a skill', 'add a command' — alongside the current domain terms.

DimensionReasoningScore

Specificity

The description names the domain ('Documentation and extension workflows') and enumerates topic areas ('docs, explanation, issues, prototypes, tutorials, MCP design review'), but contains no concrete action verbs — it never states what the skill actually does (create, draft, standardize, review). This matches the anchor 'Names the domain but actions are minimal or generic' rather than level 3, which requires 1-2 concrete actions like 'creates documentation' or 'drafts issues'.

2 / 5

Completeness

The 'what' is moderately clear (documentation/extension workflows sourced from local slash commands) but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guidelines. It does not reach level 4 because the 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Relevant keywords are present ('documentation', 'explanation', 'issues', 'prototypes', 'tutorials', 'MCP design review', 'slash commands') but common variations users would naturally say are missing — e.g. 'write docs', 'article', 'video tutorial', 'spec', 'AI IDE', 'add a skill/command'. Level 4 requires good keyword coverage with only a few natural terms missing; here the how-a-user-phrases-it layer is largely absent.

3 / 5

Distinctiveness Conflict Risk

Scoping to 'local slash commands' and niche items like 'MCP design review' and 'prototypes' gives it some distinctiveness, but 'documentation' workflows broadly overlap with any general docs/writing skill. It sits at 'somewhat specific but could still overlap with similar skills' rather than level 4, since the headline term 'Documentation ... workflows' is generic without sharper triggers.

3 / 5

Total

11

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

TencentCloudBase/CloudBase-AI-Toolkit

Path

skills/docs-workflows/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.