sketch-to-text
This skill should be used when the user asks to "convert this PDF to markdown", "convert this image to quarto", "turn my diagram into mermaid", "transcribe my notes", "sketch to text", "scribble to quarto", "turn this sketch into a document", "process my Boox export", or provides a JPEG/PNG/PDF file path and wants it converted to structured text. Converts handwritten notes and diagrams (from Onyx Boox or any source) into Quarto (.qmd) or Markdown with Mermaid diagrams.
93
92%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
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 description that thoroughly covers trigger terms, specific capabilities, and clear usage conditions. It front-loads numerous natural user phrases that would help Claude match this skill accurately. The only minor weakness is that the structure is slightly inverted (triggers before capabilities), but the content is comprehensive and distinctive.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: converts handwritten notes and diagrams, produces Quarto (.qmd) or Markdown output, generates Mermaid diagrams, handles Onyx Boox exports, processes JPEG/PNG/PDF files into structured text. | 3 / 3 |
Completeness | Clearly answers both 'what' (converts handwritten notes and diagrams into Quarto/Markdown with Mermaid diagrams) and 'when' (explicit 'Use when' equivalent at the start listing numerous trigger scenarios and file types). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger phrases users would say: 'convert this PDF to markdown', 'turn my diagram into mermaid', 'transcribe my notes', 'sketch to text', 'scribble to quarto', 'process my Boox export', plus file format mentions (JPEG/PNG/PDF). | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche: handwritten note conversion, Onyx Boox exports, sketch-to-text, Quarto output with Mermaid diagrams. These are very specific triggers unlikely to conflict with generic PDF or markdown skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%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 that provides clear, actionable guidance for a complex multi-step conversion task. The workflow is well-sequenced with explicit validation checkpoints, the mapping tables provide concrete executable syntax, and supplementary content is appropriately split into reference files. Minor verbosity in a few areas prevents a perfect conciseness score, but overall the content is strong.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient and provides necessary detail for a complex multi-step task, but some sections could be tightened — e.g., the node shape mapping table includes explanatory 'Notes' column that's somewhat redundant, and some instructions restate things Claude would infer (like 'Note the total page count'). Overall reasonably lean for the complexity involved. | 2 / 3 |
Actionability | The skill provides highly concrete, actionable guidance: specific Mermaid syntax for each shape/arrow type, exact fencing formats for qmd vs md, specific self-check rules, and concrete examples of uncertainty callout blocks. The mapping tables and code examples are copy-paste ready. | 3 / 3 |
Workflow Clarity | The workflow is clearly sequenced (Steps 1-6) with an explicit self-check/validation step (Step 4b) that includes specific things to verify and a fix-then-proceed loop. The feedback loop for Mermaid syntax validation before writing is well-defined, and the reporting step provides a clear completion checkpoint. | 3 / 3 |
Progressive Disclosure | The skill provides a clear overview with well-signaled one-level-deep references to output-templates.md, conversion-guide.md, and troubleshooting.md. Core content is inline while detailed/supplementary material is appropriately delegated to reference files. The evals caveat is a nice touch for safety. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- Repository
- Alexhans/blog-samples
- Commit
4caeb22
- 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.