CtrlK
BlogDocsLog inGet started
Tessl Logo

docx-read-fallback

Use run_shell with python-docx as reliable fallback when read_file fails on .docx files

72

Quality

87%

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

SKILL.md
Quality
Evals
Security

Quality

Content

100%

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 tight, well-organized, single-purpose skill with executable examples, a clear recovery workflow, and no unnecessary padding. It is already strong across all content dimensions.

DimensionReasoningScore

Conciseness

The body is lean, assumes Claude's competence, and avoids explaining what .docx files or python-docx are; the only minor redundancy (the Basic vs run_shell blocks showing near-identical commands) is justified by demonstrating the tool-invocation syntax, so it holds at the 'lean and efficient' anchor.

3 / 3

Actionability

It provides fully executable python one-liners for text, indexed paragraphs, tables, and headings, plus a prerequisite check and install command, matching the 'fully executable, copy-paste ready' anchor.

3 / 3

Workflow Clarity

As a simple single-purpose read-only skill, its 5-step Example Workflow is clearly sequenced and includes a verification checkpoint (verifying python-docx availability); the destructive/batch cap does not apply since extraction is non-destructive, so it reaches anchor 3 under the simple-skills note.

3 / 3

Progressive Disclosure

There are no bundle files and no nested references; the single-task skill is organized into clearly signaled sections (When to Use, How to Use, Prerequisites, Tips, Example Workflow) with content appropriately inline, satisfying the 'well-organized sections, no external references needed' guidance.

3 / 3

Total

12

/

12

Passed

Description

75%

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 is concise, third-person, and explicitly pairs a concrete fallback action with a clear trigger condition. Its main weakness is narrow action coverage and tool-centric rather than natural user trigger terms.

Suggestions

Add natural user-facing trigger terms such as 'Word document' or 'Word file' alongside '.docx files' so the description matches what a user would actually say.

Broaden the capability statement slightly (e.g., mention extracting text, paragraphs, tables, and headings) to list multiple concrete actions rather than a single fallback action.

DimensionReasoningScore

Specificity

It names a concrete domain and action ("Use run_shell with python-docx" "on .docx files") but describes essentially one fallback action rather than listing multiple specific concrete actions, so it sits at anchor 2 rather than 3.

2 / 3

Completeness

It answers both 'what' (use run_shell with python-docx as fallback) and 'when' ("when read_file fails on .docx files") with explicit trigger guidance, so it is not capped at 2 and reaches the explicit-triggers anchor.

3 / 3

Trigger Term Quality

It includes relevant keywords ("read_file fails", ".docx files", "run_shell") but these are tool-centric; it misses natural user variations like "Word document" or "can't read this file", matching the 'some relevant keywords but missing common variations' anchor.

2 / 3

Distinctiveness Conflict Risk

The niche is clear and narrow (.docx reading fallback when read_file fails), with distinct triggers unlikely to fire for unrelated skills, matching the 'clear niche with distinct triggers' anchor.

3 / 3

Total

10

/

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
HKUDS/OpenSpace
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.