CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

doc-to-markdown

Converts DOCX/PDF/PPTX and saved HTML/HTM to high-quality Markdown with automatic post-processing. Fixes pandoc grid tables, simple tables, image paths, CJK bold spacing, attribute noise, and code blocks; for PDFs also strips OCR garbage blocks, repeated headers/footers/watermarks, and absolute image paths from pymupdf4llm output. Trigger on "convert document", "docx to markdown", "parse word", "doc to markdown", "解析word", "转换文档", "HTML to Markdown".

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-engineered, information-dense skill body: executable commands throughout, fix tables with test-coverage pointers, explicit validation procedures with feedback loops, and a clean one-level reference structure fully backed by real bundle files. The main residuals are minor trimmable verbosity and an end-to-end pipeline order the reader must piece together from topic sections.

DimensionReasoningScore

Conciseness

The body is dense and efficient — fix tables, copy-paste commands, and known-limits lists with almost no concept-teaching padding — but the closing "Next Step" suggestion script, the "intelligent multi-tool orchestration" flourish, and four repeated links to heavy-mode-guide.md are trimmable. This matches anchor 4 (efficient, minor over-explanation) rather than 5, and is well above anchor 3 since nothing explains material Claude already knows.

4 / 5

Actionability

Quick Start gives fully executable `uv run --with ...` commands with dependencies, and every bundled tool (merge_outputs.py, extract_pdf_images.py, convert_path.py, the validator) has a concrete invocation. This matches anchor 5: copy-paste ready commands covering the common DOCX/PDF/HTML/test cases; the only soft spot (the `tests/` unittest command) is explicitly scoped to the source checkout, not the bundle.

5 / 5

Workflow Clarity

Validation is clearly present despite the batch nature of the skill: a dedicated Quality Validation section, PDF delivery gated on the acceptance procedure ("Before delivering a PDF conversion... follow the PDF acceptance procedure"), and an explicit feedback loop ("Verify source `href` occurrences against the emitted Markdown AST, then rerun scripts/html_to_markdown.py after cleanup or merging"). It sits at anchor 4 rather than 5 because the end-to-end order (convert → validate → merge → deliver) must be assembled from topic sections, and the DOCX path's validation step is only implied via the validator's CLI note.

4 / 5

Progressive Disclosure

The body is a true overview: all seven references/ files exist, are linked with descriptive purposes, and sit exactly one level deep; the Bundled Scripts table inventories the main scripts while auxiliary ones (batch_html.py, reader_pilot_gate.py) are surfaced through the prominently linked html-conversion.md; fixture data lives separately in assets/. This matches anchor 5 — clear overview, well-signaled one-level references, easy navigation.

5 / 5

Total

18

/

20

Passed

Description

92%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 strong description: third-person voice, comprehensive concrete capabilities, and an explicit trigger clause with natural English and Chinese phrases. The one real gap is trigger coverage for PDF and PPTX conversions (no "PDF to markdown" or extension terms); note also that disable-model-invocation: true in the frontmatter means these triggers are surfaced to the user rather than used for automatic model invocation, which does not change the text-quality scores above.

DimensionReasoningScore

Specificity

The description lists many concrete actions with named mechanics: "Converts DOCX/PDF/PPTX and saved HTML/HTM to high-quality Markdown", "Fixes pandoc grid tables, simple tables, image paths, CJK bold spacing, attribute noise, and code blocks", and "strips OCR garbage blocks, repeated headers/footers/watermarks". Coverage across formats and post-processing fixes is comprehensive, matching anchor 5 rather than anchor 4's 'minor gaps in coverage'.

5 / 5

Completeness

Both halves are explicit: the 'what' is the concrete conversion-plus-fixes description, and the 'when' is the explicit clause "Trigger on 'convert document', 'docx to markdown', 'parse word', ..." with concrete phrases. This matches the anchor-5 example pattern (clear what AND when with concrete trigger phrases), not anchor 4 where the 'when' is only generic.

5 / 5

Trigger Term Quality

Trigger phrases are natural and varied ("convert document", "docx to markdown", "parse word", "解析word", "转换文档", "HTML to Markdown"), but coverage misses common phrasings for two of the four supported formats — no "PDF to markdown", no PPTX-related term, and no file extensions like .pdf or .docx. That fits anchor 4 ('good keyword coverage; a few natural terms missing') rather than anchor 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

The niche — multi-format document-to-Markdown conversion with named post-processing cleanups — is distinct, and triggers like "docx to markdown" and "解析word" would not plausibly fire a document-editing or cleanup skill. Only "convert document" is mildly broad, which is comparable to the anchor-5 example's own breadth, so it stays at 5 rather than dropping to anchor 4's 'minor overlap risk'.

5 / 5

Total

19

/

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

relative_links

Relative link issues: 1 missing, 1 suspicious

Warning

Total

15

/

16

Passed

Repository

daymade/claude-code-skills

Path

daymade-docs/doc-to-markdown/SKILL.md

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.