CtrlK
BlogDocsLog inGet started
Tessl Logo

pandic-office

Convert Markdown to PDF (or DOCX/EPUB/HTML) using the `pandoc` CLI. Use when asked to produce a PDF report, brief, summary, or any document where the input is Markdown and the output should be a polished, paginated file.

69

Quality

87%

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

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.

The body is exemplary for a simple conversion skill: fully executable commands, environment facts Claude cannot infer (install paths, non-interactive engines), practical troubleshooting, and explicit scope boundaries against overlapping skills. Only minor token trims (sample heredoc content, path repetition) keep it from a perfect score.

DimensionReasoningScore

Conciseness

The body is lean — no explanations of what pandoc or PDF is, a terse flags table, and one-line troubleshooting fixes — but the ~8 lines of sample brief content inside the heredoc and the repeated `/workspace/$(basename "$PWD")` path construction are minor tokens that could be trimmed, matching the anchor for efficient content with slight over-elaboration rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Fully executable, copy-paste-ready commands cover all four output formats, plus a complete worked example (create input, convert with margin/fontsize flags), a flags reference, a concrete `commonly_attach_file` call with parameters, and specific fixes for each failure mode — fully covering the common cases.

5 / 5

Workflow Clarity

This is a simple single-task skill whose action is unambiguous: conversion commands are exact, the convert-then-attach sequence is explicit, and no destructive or batch operations exist, so the validation cap does not apply and the simple-skill exception holds; a brief 'verify the file was produced' checkpoint is the only conceivable addition.

5 / 5

Progressive Disclosure

The skill has no bundle files and needs none at this size; the body is well-organized into clearly headed sections (conversions, worked example, flags, post-processing, troubleshooting, when-not-to-use), which under the under-50-lines/simple-skill guideline merits the top score.

5 / 5

Total

19

/

20

Passed

Description

75%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 third-person description that clearly states both what the skill does and when to use it, with concrete output formats and named tooling. Its main gaps are missing common trigger synonyms (.pdf, Word document, e-book) and the absence of explicit triggers for the non-PDF output formats.

Suggestions

Add natural trigger synonyms and file extensions, e.g. ".pdf", "Word/DOCX", "e-book", so users asking for a Word or EPUB output in casual terms also match.

Make the 'when' clause equally concrete for all four output formats rather than centering triggers on PDF reports/briefs/summaries, which would raise completeness and distinctiveness.

DimensionReasoningScore

Specificity

"Convert Markdown to PDF (or DOCX/EPUB/HTML) using the `pandoc` CLI" enumerates four concrete conversion targets and the exact tool, matching the anchor for several specific actions with minor gaps; it falls short of 5 because coverage is not comprehensive (no mention of options like TOC, styling, or merging) and short of 3 because it goes beyond 1-2 generic actions.

4 / 5

Completeness

Both parts are explicit: the what ("Convert Markdown to PDF (or DOCX/EPUB/HTML) using the `pandoc` CLI") and the when ("Use when asked to produce a PDF report, brief, summary, or any document where the input is Markdown..."); it is not 5 because the when-clause leans on the slightly abstract "polished, paginated file" and gives no distinct triggers for the DOCX/EPUB/HTML outputs.

4 / 5

Trigger Term Quality

Natural phrases users would say are present ("PDF report", "brief", "summary", "Markdown", format names), giving good keyword coverage; it is not 5 because common synonyms and extensions like ".pdf", "Word document", or "e-book" are missing, and not 3 because the included terms go beyond merely relevant keywords.

4 / 5

Distinctiveness Conflict Risk

The pandoc-based Markdown-to-document conversion niche is distinct with concrete triggers, but phrases like "report, brief, summary" carry minor overlap risk with general office/document skills whose boundaries are only delineated in the body, not the description; this sits between anchor 3 and the clear-niche anchor 5.

4 / 5

Total

16

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Team-Commonly/commonly
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.