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.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

92%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-structured, highly actionable skill body with a clear sequenced workflow, an explicit self-check validation step, and clean progressive disclosure to verified reference files. The only nit is minor redundancy of the labeled-arrow guidance across a few sections.

Suggestions

State the labeled-arrow rule once authoritatively (e.g. in the Arrow mapping table) and have Step 3 and the Step 4b checklist reference it rather than restating it, to tighten conciseness.

Dimension	Reasoning	Score
Conciseness	Lean and free of concept padding (no explanations of what PDFs/Mermaid are), assuming Claude's competence; held just below 5 by minor repetition of the labeled-arrow rule across Step 3, Step 4b, and the Arrow mapping table.	4 / 5
Actionability	Provides copy-paste ready Mermaid syntax (node["text"], -- label -->), shape/arrow mapping tables, multiline-label and qmd/md fencing examples, and callout block templates that cover the common conversion cases, matching the level-5 anchor.	5 / 5
Workflow Clarity	A clear Step 1–6 sequence with an explicit Step 4b validation/self-check checklist and a fix-then-note-if-uncertain feedback loop, satisfying the level-5 anchor; validation is present so the destructive/batch cap does not apply.	5 / 5
Progressive Disclosure	Well-signaled one-level-deep references to real bundle files (output-templates.md, conversion-guide.md, troubleshooting.md) in the Additional Resources section, with detailed material split out and the core workflow kept inline, matching the level-5 anchor.	5 / 5
	Total	19 / 20 Passed

Description

96%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 that explicitly states both what the skill does and when to use it, with comprehensive natural trigger phrases and synonyms. The only weakness is one generic PDF-conversion trigger that introduces minor conflict risk with broader PDF skills.

Suggestions

Differentiate the "convert this PDF to markdown" trigger by scoping it to handwritten/diagram content (e.g. "convert this handwritten PDF to markdown") to reduce overlap with generic PDF-extraction skills.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions—"convert this PDF to markdown", "turn my diagram into mermaid", "transcribe my notes", "process my Boox export", "Converts...into Quarto (.qmd) or Markdown with Mermaid diagrams"—with comprehensive coverage of the domain, matching the level-5 anchor.	5 / 5
Completeness	Explicitly answers "when" ("This skill should be used when the user asks to..." plus the JPEG/PNG/PDF file-path condition) and "what" ("Converts handwritten notes and diagrams...into Quarto (.qmd) or Markdown with Mermaid diagrams") with concrete trigger phrases, matching the level-5 anchor.	5 / 5
Trigger Term Quality	Comprehensive natural trigger phrases including synonyms ("sketch to text", "scribble to quarto", "turn this sketch into a document") and file extensions (JPEG/PNG/PDF), matching the level-5 anchor that asks for synonyms and extensions.	5 / 5
Distinctiveness Conflict Risk	A clear niche (handwritten notes/diagrams from Boox to Mermaid/Quarto) with distinct triggers, but the generic trigger "convert this PDF to markdown" creates minor overlap risk with general PDF-extraction skills, keeping it just below level 5.	4 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: Alexhans/blog-samples
Path: skills/sketch-to-text/SKILL.md
Commit: 02102c4

Reviewed: 15 days ago

Table of Contents

Discovery Implementation Validation

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.