CtrlK
BlogDocsLog inGet started
Tessl Logo

document-skills

Umbrella skill for document workflows (PDF/DOCX/XLSX/PPTX). Dispatches to the most specific document skill to reduce noise and improve routing precision.

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 ./bundled/skills/document-skills/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 concise, well-structured dispatcher with concrete routing rules and sensible safety controls. Its main weaknesses are hedged conditional guidance in the DOCX rule and the absence of an explicit validation feedback loop for multi-output workflows.

Suggestions

Resolve the DOCX/doc ambiguity with a decisive rule instead of the conditional "when…requested/required by your environment" phrasing.

Add an explicit validation feedback loop for multi-output sequences, e.g. verify each export before producing the next derived file and re-run on failure.

Tighten the output-expectations checklist into concrete pass/fail criteria per format (e.g. "open and confirm no Excel formula errors" as a required step).

DimensionReasoningScore

Conciseness

The body is lean and well-organized with no concept over-explanation (no "what is a PDF" filler); every section earns its place and assumes Claude's competence.

3 / 3

Actionability

Routing rules are concrete and include a copy-paste clarifying question, but the DOCX rule hedges ("when…requested/required by your environment"), leaving some guidance conditional rather than fully decisive.

2 / 3

Workflow Clarity

Multi-output sequencing is given (source-of-truth → derived exports) and verification is mentioned, but there is no explicit validate→fix→retry feedback loop for batch or destructive operations.

2 / 3

Progressive Disclosure

Under 50 lines with no need for external references and clearly organized sections (dispatch rules, safety controls, output expectations), meeting the simple-skill bar for progressive disclosure.

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 clearly conveys a dispatcher purpose and names the relevant formats, but it lacks an explicit "Use when…" trigger clause and relies on abbreviated format keywords. It is serviceable but not maximally specific or distinctive.

Suggestions

Add an explicit trigger clause, e.g. "Use when the task is clearly document work but the target format is unclear or multiple formats are mixed."

Expand trigger terms to natural user phrasing such as Word, Excel, slides, spreadsheets, and decks rather than only file extensions.

Clarify the distinction from the specific format skills by stating it routes rather than performs the document work itself.

DimensionReasoningScore

Specificity

Names the document domain and four formats plus a concrete action ("Dispatches to the most specific document skill"), but it lists only one routing action rather than multiple concrete document operations.

2 / 3

Completeness

It clearly answers what the skill does, but there is no "Use when…" clause or equivalent explicit trigger guidance, so completeness is capped at 2 per the rubric guidelines.

2 / 3

Trigger Term Quality

Natural format keywords (PDF/DOCX/XLSX/PPTX, "document") are present but in abbreviated slash-form, missing common variations like Word, Excel, or slides that users would actually say.

2 / 3

Distinctiveness Conflict Risk

The dispatcher role ("Dispatches to the most specific document skill") is a distinct niche, but it triggers on the same format terms as the very skills it routes to, creating overlap risk.

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
foryourhealth111-pixel/Vibe-Skills
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.