CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-doc-delivery

Convert markdown to DOCX, PPTX, XLSX, PDF office documents — use when you need exportable deliverables

50

Quality

53%

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

Quality

Content

42%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 skill body is well-structured on the surface (clear headings, patterns, edge cases) but padded with generic office-document advice Claude already knows and built around pseudo-instructions that delegate to other skills without concrete executable commands. Workflow steps lack any validation checkpoints, and much of the format-specific guidance should be offloaded to reference files that do not exist.

Suggestions

Cut the 'Professional Styling Tips' and per-format 'Best Practices' sections (or move them to a references/ file) — slide and document formatting conventions are knowledge Claude already has and they consume most of the token budget.

Replace the fenced pseudo-dialogs ('Use the /document-skills:docx skill to convert markdown...') with the actual command or invocation syntax and a concrete end-to-end example, including the output save path.

Add validation checkpoints to the workflow — verify the source file exists before converting, and confirm the output file was created (e.g., check it exists / opens) before reporting success, especially for the batch-conversion pattern.

Fix or remove the dangling reference to 'skills/blocks/codex-host-adapter.md' and the unprefixed external commands (/octo:*, /document-skills:*) — either ship those reference files or drop the pointers.

DimensionReasoningScore

Conciseness

The ~350-line body is noticeably verbose with several padded sections that restate knowledge Claude already has: 'One main idea per slide', '5-7 bullet points max per slide', 'Use built-in heading styles (Heading 1, Heading 2...)', 'Add table of contents for documents >5 pages'. The three conversion patterns and three example workflows each repeat the same four steps with only cosmetic differences, and 'Apply Professional Styling' plus the per-format 'Best Practices' sections largely duplicate each other. This matches the anchor for several unnecessary explanations or padded sections, not the severely padded 1 since the content is on-topic.

2 / 5

Actionability

There is some concrete guidance — 'ls -lht ~/.claude-octopus/results/ | head -10' and '/plugin install document-skills@anthropic-agent-skills' are executable — but the core conversion step is presented as fenced pseudo-dialog ('Use the /document-skills:docx skill to convert markdown to Word format.') rather than an actual command or code the model can run. There is no example of how to invoke the sub-skill, save output to a path, or verify the result, so it matches the 'some concrete guidance but incomplete; pseudocode instead of executable code' anchor rather than the mostly-executable 4.

3 / 5

Workflow Clarity

The four-step sequence (locate source → choose format → convert via plugin → apply styling) is clearly listed, and the edge-case section handles missing outputs, unspecified format, and multiple files. However, there are no validation checkpoints — nothing confirms the source markdown was read successfully, the plugin invocation worked, or the output file was produced and opens correctly (relevant for the batch-conversion pattern), matching the 'steps listed but validation gaps' anchor. Not a 2 because the sequence itself is coherent and edge cases are explicitly enumerated.

3 / 5

Progressive Disclosure

The body has consistent section headers and a quick-reference command block, so it is navigable, but it is a single monolithic file whose per-format best-practice and example sections (150+ lines) clearly belong in separate reference files. It also cites 'skills/blocks/codex-host-adapter.md', which does not exist in the bundle (no references/ or scripts/ directories are present), and leans on external slash commands (/octo:*, /document-skills:*) without signaling where their documentation lives. This matches the 'some structure but content that should be separate is inline' anchor.

3 / 5

Total

11

/

20

Passed

Description

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

A reasonably effective description: it states a concrete conversion capability across four named formats and includes an explicit 'use when' trigger. Weaknesses are the single action verb, second-person phrasing in the trigger clause, and missing natural synonyms (Word/PowerPoint/Excel) that users would actually say.

Suggestions

Rewrite the trigger clause in third person with concrete user-side phrases, e.g. 'Convert markdown files to DOCX, PPTX, XLSX, and PDF office documents. Use when the user asks to export or convert markdown to Word, PowerPoint, Excel, or PDF deliverables.'

Add natural synonyms users would say — 'Word', 'PowerPoint', 'Excel', 'export', 'deck', 'report' — alongside the file extensions to improve trigger matching.

Briefly enumerate the distinct capabilities (single-file conversion, batch conversion, professional styling) so the 'what' is more comprehensive.

DimensionReasoningScore

Specificity

The description names one concrete action — 'Convert markdown to DOCX, PPTX, XLSX, PDF office documents' — which fits the anchor for naming the domain with minimal/generic actions; it lists no secondary capabilities (styling, batch conversion, output organization). Additionally, 'use when you need exportable deliverables' uses second person ('you'), which per the judging guidelines reduces the specificity score by 1 from an initial 3.

2 / 5

Completeness

Both parts are present: a clear 'what' ('Convert markdown to DOCX, PPTX, XLSX, PDF office documents') and an explicit trigger ('use when you need exportable deliverables'). The 'when' could be more concrete — it names no user-side triggers like 'when the user asks for a Word/PowerPoint export', so it matches the anchor where 'when' could be more explicit or specific rather than the fully-trigger-anchored 5.

4 / 5

Trigger Term Quality

Good keyword coverage including file extensions ('DOCX, PPTX, XLSX, PDF') and 'markdown', 'office documents', 'exportable deliverables'. A few natural terms users would say are missing — 'Word', 'PowerPoint', 'Excel', 'convert to a deck/report', 'export to PDF' phrasing.

4 / 5

Distinctiveness Conflict Risk

The markdown-to-office-conversion niche with named formats is fairly distinct and unlikely to fire on unrelated skills. Minor overlap risk exists with the document-skills docx/pptx/pdf skills it delegates to — a request like 'convert this to Word' could plausibly match either, keeping it below a 5.

4 / 5

Total

14

/

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
nyldn/claude-octopus
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.