CtrlK
BlogDocsLog inGet started
Tessl Logo

doc

Read, create, and edit .docx documents with formatting and layout fidelity via OpenAI's document skill.

52

Quality

58%

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

Quality

Content

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

The body is well-organized and concise as a catalogue entry, but it provides almost no actionable or workflow guidance for the advertised docx-editing capability.

Suggestions

Add at least one concrete, executable example or command for reading/creating/editing .docx files instead of only pointing to the upstream repo.

Provide a real editing workflow with explicit validation steps (e.g., unpack, edit, validate, repack) rather than a generic install pointer.

Replace the restated description in 'What it does' with substantive task detail so the section earns its place.

DimensionReasoningScore

Conciseness

The body is lean and does not over-explain what a .docx is, though it restates the description verbatim and leans on catalogue meta-talk rather than task content.

4 / 5

Actionability

It gives no executable code or commands for reading/creating/editing docx; the only guidance is opening a GitHub URL and asking the agent to invoke the skill, leaving the specific steps to execute.

2 / 5

Workflow Clarity

The described sequence (inspect upstream README, install bundle, invoke by name) is a catalogue pointer with many gaps and no validation checkpoints, not a docx-editing workflow.

2 / 5

Progressive Disclosure

This under-50-line entry is cleanly sectioned (What it does, Source, How to use), though it points to an upstream repo rather than local bundle references and the call-to-action is weak.

4 / 5

Total

12

/

20

Passed

Description

58%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 specific and reasonably distinct but lacks explicit 'when to use' trigger guidance, which caps its completeness and leaves its trigger-term coverage thin.

Suggestions

Add a 'Use when...' clause naming concrete triggers such as Word/.docx editing, layout fidelity, or formatting preservation.

Include natural synonyms users actually say ('Word docs', 'Word documents') alongside '.docx' in the description.

Mention concrete secondary actions (forms, merge, conversion) to round out coverage toward a specificity score of 5.

DimensionReasoningScore

Specificity

Names the .docx domain with three concrete verbs ('Read, create, and edit') plus a fidelity concern, listing several specific actions with only minor coverage gaps (e.g., no form/merge/conversion).

4 / 5

Completeness

It clearly states what the skill does but offers no 'Use when...' guidance, and the rubric caps completeness at 3 when such trigger guidance is missing.

3 / 5

Trigger Term Quality

The description surfaces only '.docx' as a natural term and misses common synonyms like 'Word' or 'Word docs'; trigger phrases live in frontmatter rather than the description itself.

3 / 5

Distinctiveness Conflict Risk

Scoped to .docx/Word editing with a layout-fidelity angle, it is mostly distinct with only minor overlap risk against other document skills.

4 / 5

Total

14

/

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.

Validation15 / 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.