CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-doc-delivery

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

52

Quality

59%

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

Quality

Content

48%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-sequenced with a useful prerequisite check and thorough edge-case coverage, but it is bloated with generic document-design knowledge Claude already possesses and heavy duplication, and it delegates the actual conversion work without any executable conversion command or code. Moving format-specific best practices, styling tips, and worked examples into reference files would cut the token cost substantially.

Suggestions

Cut the generic guidance Claude already knows (slide design rules like '5-7 bullet points max', DOCX/PPTX/PDF best-practices lists, 'Best Practices', 'Getting Help', and 'Integration with Knowledge Mode' sections) — keep only the claude-octopus-specific routing knowledge, and deduplicate the plugin-install instructions that appear three times.

Replace the delegation-shaped 'Use the /document-skills:docx skill' hints and pseudocode example workflows with the concrete invocation or command the user's agent should actually run for each format, so the core conversion step is executable rather than described.

Move the format-recommendation tables, styling tips, and worked examples into one-level-deep reference files (e.g., references/formats.md, references/examples.md) linked from a lean overview, and add a post-conversion verification step (confirm the output file exists and opens) to the workflow.

DimensionReasoningScore

Conciseness

The ~350-line body contains several padded sections that restate knowledge Claude already has: 'One main idea per slide', '5-7 bullet points max per slide', 'Use consistent fonts and colors', 'Add table of contents for documents >5 pages', plus generic advice like 'Readability - Break up long paragraphs, use white space' and 'Test Compatibility'. There is also heavy duplication (prerequisites and install commands appear in 'Prerequisites Check', 'Handling Edge Cases', and again in 'Quick Reference Commands'; format recommendations appear in both 'Format Recommendations by Workflow' and 'Step 2'). This matches the anchor 'noticeably verbose; several unnecessary explanations or padded sections' rather than a 3, where the padding would be isolated.

2 / 5

Actionability

Concrete elements exist — real bash commands ('ls -lht ~/.claude-octopus/results/ | head -10', '/plugin install document-skills@anthropic-agent-skills') and named target skills — but the core conversion guidance is delegation-shaped rather than executable ('Use the /document-skills:docx skill to convert markdown to Word format. Supports headings, lists, tables, and formatting.') and the example workflows read like pseudocode ('1. Read the empathize markdown 2. Extract persona sections 3. Convert to PPTX'). No actual conversion command, script invocation, or code is shown, matching the anchor 'some concrete guidance but incomplete; missing key details'.

3 / 5

Workflow Clarity

The process is clearly sequenced (Step 1 locate source → Step 2 choose format → Step 3 use plugin → Step 4 styling) with an explicit prerequisites check up front ('/plugin list | grep document-skills') and dedicated edge-case handling for missing plugin, missing files, unspecified format, and multiple candidates. It is not a 5 because there is no verification checkpoint after conversion (e.g., confirming the output file opens or content survived), fitting the anchor 'clear sequence with most checkpoints present; minor validation gaps'. No destructive or batch validation cap applies.

4 / 5

Progressive Disclosure

The body has a well-labeled section structure (Overview, Prerequisites, Guidelines, Patterns, Edge Cases, Quick Reference) but no bundle files exist at all (no references/, scripts/, or assets/), so roughly 250 lines of format-specific best practices, styling tips, and worked examples are inlined in the monolithic SKILL.md. This fits the anchor 'some structure but could be better organized; content that should be separate is inline'; it is above a 2 because section headers and navigation are genuinely clear, and above a 4 is ruled out since nothing is split out.

3 / 5

Total

12

/

20

Passed

Description

70%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 concise, third-person description that clearly states what the skill does and when to use it, with good format-extension trigger terms. Its main gaps are a single-action capability statement, abstract 'when' phrasing, and natural-synonym triggers (Word/PowerPoint/Excel) that would sharpen activation.

DimensionReasoningScore

Specificity

The description names the domain and concrete conversion targets ('Convert markdown to DOCX, PPTX, XLSX, PDF office documents'), but lists only one action (convert) rather than several specific capabilities. It matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive'; a 4 would require several distinct actions like the anchor example 'Extracts text from PDF files, fills forms, converts pages to images'.

3 / 5

Completeness

Both parts are present: the 'what' is concrete ('Convert markdown to DOCX, PPTX, XLSX, PDF office documents') and an explicit 'use when you need exportable deliverables' clause gives the 'when'. It is not a 5 because 'when you need exportable deliverables' is abstract — it lacks concrete user-trigger phrases like 'when the user asks to export to Word or create a PowerPoint', fitting the anchor 'both what and when; when could be more explicit or specific'.

4 / 5

Trigger Term Quality

Strong keyword coverage including file extensions (DOCX, PPTX, XLSX, PDF), 'markdown', 'office documents', and 'exportable deliverables', which map to natural user requests like 'convert to DOCX'. It falls short of a 5 because common natural synonyms such as 'Word', 'PowerPoint', 'Excel', 'presentation', or 'export to Word' are missing, matching the anchor 'good keyword coverage; a few natural terms missing'.

4 / 5

Distinctiveness Conflict Risk

The markdown-to-office-format niche is fairly distinct with concrete format triggers, but there is real overlap risk with the document-skills plugin's own docx/pptx/pdf conversion skills — the same 'convert this markdown to Word' request could match either. This fits the anchor 'mostly distinct; minor overlap risk with closely related skills' rather than a 5 with minimal conflict risk.

4 / 5

Total

15

/

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