markdown-to-pdf

Convert a markdown file to PDF using mistune + reportlab. Use when the user wants to convert a .md file to PDF, or when another skill needs to produce a PDF from markdown output.

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

100%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 content is a model example of a simple, single-purpose skill: lean, fully executable commands with concrete examples, an unambiguous workflow with a documented JSON success/error contract, and clean sections with a verified one-level-deep script reference. No padding, no inference-dependent steps, no time-sensitive clutter.

Dimension	Reasoning	Score
Conciseness	The ~55-line body is lean throughout: a one-line summary, dependency pins, a single executable command, documented output fields, two terse examples, and a short feature list. There is no explanation of concepts Claude already knows (no 'what a PDF is', no library tutorials), matching the 5 anchor ('every token earns its place').	5 / 5
Actionability	The instruction is a fully executable, copy-paste-ready command (`uv run python .claude/skills/markdown-to-pdf/scripts/markdown_to_pdf.py <input.md> [output.pdf]`) with both a default-output and an explicit-output example, and the JSON result contract (success/input/output/error) is documented — matching the 5 anchor ('copy-paste ready... examples cover the common cases').	5 / 5
Workflow Clarity	This is a simple single-task skill and the single action is unambiguous: run the script with an input path, then report the output path. Per the rubric's simple-skill rule, workflow clarity can score 5; the documented `success`/`error` JSON fields also provide an explicit error-feedback checkpoint, ruling out the 4 anchor's 'minor validation gaps'.	5 / 5
Progressive Disclosure	The body is under 50 lines with well-organized sections (Dependencies, Instructions, Output, Examples, Supported Markdown) and its only reference — `scripts/markdown_to_pdf.py` — is a real, verified bundle file referenced one level deep. Per the rubric's guideline for skills under 50 lines needing no external references, this matches the 5 anchor.	5 / 5
	Total	20 / 20 Passed

Description

87%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 well-crafted description: concrete, third-person, with an explicit 'Use when' clause covering both direct user requests and inter-skill invocation. Keyword coverage is good but could add a few natural synonyms (e.g., 'md', 'render markdown as PDF') to reach the top anchor on trigger terms.

Dimension	Reasoning	Score
Specificity	"Convert a markdown file to PDF using mistune + reportlab" names the domain, the concrete action, and the implementation tooling. For a single-purpose skill this is near-complete coverage, but it lists only one action rather than multiple specific actions, so it sits between the 3 and 5 anchors — closer to 4.	4 / 5
Completeness	The description explicitly answers both questions: "Convert a markdown file to PDF using mistune + reportlab" (what) and "Use when the user wants to convert a .md file to PDF, or when another skill needs to produce a PDF from markdown output" (when, with two concrete trigger phrases). This matches the 5 anchor exactly; the 4 anchor requires the 'when' to be less explicit, which it is not.	5 / 5
Trigger Term Quality	Natural trigger terms are present: "convert", "markdown file", "PDF", and the file extension ".md file". Common synonyms such as "md", "render markdown as PDF", or "PDF export" are missing, matching the 4 anchor ('good keyword coverage; a few natural terms missing') rather than the comprehensive 5.	4 / 5
Distinctiveness Conflict Risk	"markdown" + ".md file" + "PDF" carve a clear niche (markdown-to-PDF conversion) with distinct triggers and minimal overlap with generic document or PDF-extraction skills, matching the 5 anchor. The 4 anchor would apply if it overlapped with closely related skills, which it does not meaningfully do.	5 / 5
	Total	18 / 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: staskh/trading_skills
Path: .claude/skills/markdown-to-pdf/SKILL.md
Commit: b71a74f

Reviewed: 6 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.