CtrlK
BlogDocsLog inGet started
Tessl Logo

docx

Create, edit, and analyze Word documents with tracked changes, comments, and formatting. Useful for design briefs, copy docs, and review-ready deliverables.

57

Quality

66%

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 ./skills/docx/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a clean, well-organized catalogue stub rather than an operational skill: structure and token efficiency are good, but it provides no executable path to actually using the docx workflow. The pivotal instruction — installing the upstream bundle — is a high-level hint with no command, path, or verification, which caps both actionability and workflow clarity.

Suggestions

Replace the vague install instruction with the concrete command(s) to install the upstream bundle (e.g., the exact git clone or skill-install invocation and the destination path in the agent's skills directory).

Add a verification step confirming the skill is installed and invocable (e.g., listing the installed skill or a smoke-test invocation) before telling the agent to invoke it by name.

Deduplicate repeated content: the description text repeated in 'What it does' and the upstream URL appearing in both the Source section and the bash block can be consolidated to trim tokens.

DimensionReasoningScore

Conciseness

The ~30-line body is efficient with clear sections and no explanation of concepts Claude already knows, but has minor trimmable redundancy: the description is repeated verbatim in 'What it does' and the upstream URL appears twice (Source section and bash block), matching the 4 anchor. Not 5 because those duplications mean not every token earns its place.

4 / 5

Actionability

The only executable command is `open https://github.com/...` which merely points to documentation, while the core instruction — "install the upstream bundle into your active agent's skills directory" — has no concrete command, path, or steps, matching the 3 anchor's 'concrete guidance but incomplete; missing key details'. Not 4 because no guidance here actually accomplishes the skill's task; not 2 because the open command and the explicit invoke-by-name/trigger instruction are genuine, executable pointers.

3 / 5

Workflow Clarity

The rough sequence (install the upstream bundle, then invoke the skill by name or trigger) is present but the critical install step is undefined — no command, no destination path, no verification that installation succeeded — fitting the 2 anchor's 'rough sequence present but many gaps; steps poorly defined'. Not 3 because even the step listing degenerates: the first step cannot be executed from what is written, and there is no checkpoint of any kind.

2 / 5

Progressive Disclosure

The body is well under 50 lines, has no bundle files requiring organization, uses clear sections (What it does / Source / How to use), and its single external pointer (the upstream URL) is one level deep and clearly signaled, satisfying the simple-skill exception for a full score. Nothing is inlined that belongs in a separate file.

5 / 5

Total

14

/

20

Passed

Description

75%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 is solid across all dimensions: it names a clear domain, concrete actions, distinctive features, and concrete use cases. Its main weakness is the absence of an explicit 'Use when...' trigger clause and the '.docx'/'docx' keyword, which keep completeness and trigger-term quality at 4 rather than 5.

DimensionReasoningScore

Specificity

"Create, edit, and analyze Word documents with tracked changes, comments, and formatting" lists several concrete actions (create, edit, analyze) on a named domain with specific feature areas, matching the 'several specific actions; minor gaps in coverage' anchor. Not 5 because coverage has gaps — no file-extension handling, conversion, or extraction detail like the 5-anchor example's four distinct actions.

4 / 5

Completeness

The 'what' is clear (create/edit/analyze Word docs with tracked changes, comments, formatting) and a 'when' is present via "Useful for design briefs, copy docs, and review-ready deliverables", which names concrete use cases — fitting the anchor where both exist but 'when' could be more explicit. Not 5 because it lacks the explicit 'Use when...' trigger phrasing of the 5 anchor; not 3 because the when-clause is more than weakly implied — it explicitly names three applicability scenarios.

4 / 5

Trigger Term Quality

Natural terms include "Word documents", "tracked changes", "design briefs", "copy docs", and "review-ready deliverables" — good keyword coverage users would actually say. Not 5 because it omits the ".docx" extension and the literal term "docx" from the description text, which the 5 anchor explicitly expects (e.g., '.pdf' in the example).

4 / 5

Distinctiveness Conflict Risk

The Word-document niche with distinctive features like "tracked changes" and "comments" is mostly distinct with minimal conflict risk against adjacent skills, matching the 4 anchor. Not 5 because generic deliverable phrases like "design briefs" and "review-ready deliverables" could overlap with copywriting or general document/review skills, unlike the 5 anchor's tightly scoped triggers.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
nexu-io/open-design
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.