markdown-tools
Converts documents to markdown with multi-tool orchestration for best quality. Supports Quick Mode (fast, single tool) and Heavy Mode (best quality, multi-tool merge). Use when converting PDF/DOCX/PPTX files to markdown, extracting images from documents, validating conversion quality, or needing LLM-optimized document output.
Install with Tessl CLI
npx tessl i github:fernandezbaptiste/claude-code-skills --skill markdown-tools95
Does it follow best practices?
Validation for skill structure
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that excels across all dimensions. It provides specific capabilities with two distinct modes, includes natural trigger terms with common file extensions, has an explicit 'Use when...' clause covering multiple scenarios, and carves out a clear niche around document-to-markdown conversion with quality optimization features.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple concrete actions: 'Converts documents to markdown', 'multi-tool orchestration', 'Quick Mode (fast, single tool)', 'Heavy Mode (best quality, multi-tool merge)', 'extracting images', 'validating conversion quality'. These are specific, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Converts documents to markdown with multi-tool orchestration') and when ('Use when converting PDF/DOCX/PPTX files to markdown, extracting images from documents, validating conversion quality, or needing LLM-optimized document output'). Explicit 'Use when...' clause present. | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'PDF', 'DOCX', 'PPTX', 'markdown', 'converting', 'extracting images', 'documents'. Good coverage of file types and common conversion terminology. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused on document-to-markdown conversion with specific file types (PDF/DOCX/PPTX) and unique features (Quick Mode vs Heavy Mode, multi-tool orchestration). The 'LLM-optimized' qualifier further distinguishes it from generic document processing skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill with excellent conciseness and actionability. The tables provide quick reference without verbosity, and all commands are executable. The main weakness is the workflow could better integrate validation as an explicit checkpoint rather than presenting it as a separate optional step.
Suggestions
Integrate validation into the main conversion workflow as an explicit step (e.g., 'After conversion, validate: uv run scripts/validate_output.py ... If text retention <95%, use Heavy Mode')
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, using tables for quick reference and avoiding explanations of concepts Claude already knows. Every section provides actionable information without padding. | 3 / 3 |
Actionability | Provides fully executable bash commands and clear installation steps. Commands are copy-paste ready with specific flags and options documented in context. | 3 / 3 |
Workflow Clarity | Heavy Mode workflow is explained with clear steps, but lacks explicit validation checkpoints in the main conversion workflow. The validate script exists but isn't integrated as a mandatory step after conversion. | 2 / 3 |
Progressive Disclosure | Excellent structure with quick start, detailed sections, and clear references to external documentation. One-level-deep references are well-signaled at the end for advanced topics. | 3 / 3 |
Total | 11 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- 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.