CtrlK
BlogDocsLog inGet started
Tessl Logo

pdf-official

Use this skill whenever a PDF file is being produced, opened, transformed, filled, or read. That includes: extracting text or tables from an existing PDF; combining, carving, rotating, cropping, or watermarking pages; composing a fresh PDF (report, invoice, certificate); filling AcroForm fields or overlaying text onto a non-fillable scanned form; encrypting or unlocking a PDF; running OCR over a scanned document; rendering pages to PNG/JPEG for visual analysis. Trigger on mentions of 'PDF', a filename ending in .pdf, requests like 'turn this into a PDF report', or references to AcroForm / form fields.

73

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 an unusually tight, expert-level overview: excellent token efficiency, copy-paste commands, a real triage tool, and high-value gotchas. Its one serious defect is that the entire detail layer it routes to (four referenced sub-guides) is missing from the bundle, so progressive disclosure is structurally sound on paper but broken in practice, and the in-body validation loop is named rather than spelled out.

Suggestions

Ship the four referenced sub-guides (extract.md, transform.md, compose.md, interactive.md) or move them into a references/ directory matching the links — as delivered, the routing table's central instruction cannot be followed.

Add one inline validate-and-fix step (e.g., 'run scripts/sanity_check.py output.pdf; on exit 1 fix the reported findings and re-run') so the feedback loop lives in the body, not only in the missing sub-guides.

Include a minimal inline code snippet for the single most common case (e.g., pdfplumber text extraction) so the skill remains actionable even if a sub-guide is unavailable.

DimensionReasoningScore

Conciseness

The body is lean and dense: routing and library-choice tables, terse install blocks, a one-command triage with sample JSON, and gotchas that are genuinely non-obvious (coordinate origins, CJK font fallback ladder, XFA vs AcroForm, RC4 default). It explains nothing Claude already knows, matching 'Lean and efficient; assumes Claude's competence; every token earns its place'; there is no padded section to trim for score 4.

5 / 5

Actionability

Concrete, copy-paste-ready commands throughout: 'python3 -m pip install --upgrade pypdf pdfplumber pypdfium2 reportlab Pillow', 'scripts/survey.py path/to/file.pdf --pretty' with sample output, and 'qpdf --password=… --decrypt', plus a survey-flag routing list and a library-per-task decision table with fallbacks. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'; score 4 would require missing key details, and none are apparent.

5 / 5

Workflow Clarity

There is a clear pipeline order ('probe → plan → extract or compose → validate'), every path starts with the survey probe, and validation is made concrete via documented exit codes ('3 validation failure', 'sanity_check.py reports findings with exit 1') and a promised Validation section per sub-guide. This sits between anchors: better than 'most checkpoints present' alone but short of a 5, because the actual validate-and-fix feedback loop is only pointed at, not spelled out in the body (e.g., no inline 'run sanity_check.py, fix, re-run' step).

4 / 5

Progressive Disclosure

The routing table and 'What's next' section direct the reader to four sub-guides — extract.md, transform.md, compose.md, interactive.md — but none of these files exist in the bundle (no references/ directory; a filesystem check finds only SKILL.md and scripts/). The references are clearly signaled and one level deep, but they are dangling: following the skill's central instruction ('Open the sub-guide from the routing table and work through it end to end') fails immediately, which is worse than the 'minor organization gaps' of a 4 and closer to navigation being broken. The 11 scripts referenced (survey.py, probe_fields.py, apply_values.py, overlay_text.py, sanity_check.py) do all exist.

2 / 5

Total

16

/

20

Passed

Description

100%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.

An exemplary description: comprehensive concrete capabilities, explicit 'use when' triggers with natural phrasings and file extensions, and no padding or over-claims. Third-person/declarative convention is consistent with the reference examples. No weaknesses found.

DimensionReasoningScore

Specificity

The description enumerates many concrete, comprehensive actions: 'extracting text or tables', 'combining, carving, rotating, cropping, or watermarking pages', 'filling AcroForm fields or overlaying text onto a non-fillable scanned form', 'encrypting or unlocking', 'running OCR', and 'rendering pages to PNG/JPEG'. This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' and exceeds the score-4 anchor, which anticipates minor gaps in coverage.

5 / 5

Completeness

Both 'what' (the long list of capabilities) and 'when' are explicitly and concretely answered: 'Use this skill whenever a PDF file is being produced, opened, transformed, filled, or read' and 'Trigger on mentions of PDF...'. This matches the anchor 'Clearly and explicitly answers both what AND when with concrete trigger phrases'; score 4 would require the 'when' to be less explicit.

5 / 5

Trigger Term Quality

It covers natural terms and their synonyms including the extension: mentions of 'PDF', 'a filename ending in .pdf', 'AcroForm / form fields', plus user-shaped requests like 'turn this into a PDF report'. This matches 'Comprehensive coverage of natural terms including synonyms and file extensions'; the score-4 anchor ('a few natural terms missing') would apply only if obvious phrasings were absent.

5 / 5

Distinctiveness Conflict Risk

The skill occupies a clear PDF-only niche with distinct triggers ('PDF', '.pdf', 'AcroForm / form fields') and would not plausibly fire for non-PDF document work, matching 'Clear niche with distinct triggers; minimal conflict risk'. Score 4 ('minor overlap risk with closely related skills') would fit a skill that also covered, e.g., Word files, which this does not.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

relative_links

Relative link issues: 11 missing

Warning

Total

15

/

16

Passed

Repository
XiaomiMiMo/MiMo-Code
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.