CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pdf-extract

Extract PDF selectable text and full-page or segmented page images (including tables) into Markdown with per-page headings and image links; use when you need both readable text and page visuals for PPT creation, review, or analysis.

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Other/pdf-extract/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 core technical content is excellent — an executable, flag-accurate example with documented output structure — but it is buried in generic template boilerplate that roughly doubles the length, including a duplicated validation section whose 'expected output' misrepresents the actual --help output.

Suggestions

Delete the generic boilerplate sections (When Not to Use, Required Inputs, Recommended Workflow, Output Contract, Validation and Safety Rules, Failure Handling, Deterministic Output Rules, Completion Checklist) and merge the duplicated 'Validation Shortcut' and 'Quick Validation' sections into one.

Fix the 'Quick Validation' expected output to match what 'python scripts/extract_pdf.py --help' actually prints rather than a fabricated result-file format.

Replace the vague 'Recommended Workflow' steps with the concrete sequence already implicit in the example: run --help to confirm the path, run the extract command, verify the output Markdown structure and image files against the documented format.

DimensionReasoningScore

Conciseness

Roughly half the body is generic template boilerplate ('Do not use this skill when the required source data, identifiers, files, or credentials are missing', 'Keep output field names stable and do not rename documented keys') that teaches nothing about PDF extraction, and the validation command 'python scripts/extract_pdf.py --help' is duplicated in both 'Validation Shortcut' and 'Quick Validation' — several padded sections, matching anchor 2.

2 / 5

Actionability

The example command is fully executable and copy-paste ready ('python scripts/extract_pdf.py --input input.pdf --output output.md --image-dir images --image-mode segment ...'), its flags were verified against the actual script's argparse, and expected output structure is documented down to image-link naming ('![page-XX](images/page-XX-block-YY.png)') — matching the anchor-5 fully-executable example.

5 / 5

Workflow Clarity

A clear sequence exists (validate with --help first, run the documented command, expect the documented Markdown structure, handle failures via 'Failure Handling', confirm via 'Completion Checklist') but the checkpoints are diluted: the 'Quick Validation' expected output ('Result file: pdf_extract_result.md ... PASS/FAIL') does not correspond to what --help actually prints, and 'Recommended Workflow' is generic rather than command-backed — minor validation gaps, anchor 4.

4 / 5

Progressive Disclosure

Structure is sectioned and the one bundle reference (scripts/extract_pdf.py) is a real, clearly signaled path, but ~60 lines of boilerplate (Required Inputs, Output Contract, Deterministic Output Rules, duplicate validation sections) are inline filler that should be trimmed or split out, and the bundle's validate_skill.py is never mentioned — anchor 3 organization.

3 / 5

Total

14

/

20

Passed

Description

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

The description is strong: it concretely states what the skill does and includes an explicit 'use when' trigger with natural terms. Weaknesses are minor — second-person phrasing in the trigger clause and a few missing synonyms/file extensions like '.pdf'.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'Extract PDF selectable text and full-page or segmented page images (including tables) into Markdown with per-page headings and image links' — covering text extraction, two image modes, and output structure, but the trigger clause 'use when you need both readable text and page visuals' is second-person voice, which the guidelines penalize by 1 from an otherwise anchor-5 match.

4 / 5

Completeness

Explicitly answers both: what ('Extract PDF selectable text and full-page or segmented page images ... into Markdown with per-page headings and image links') and when ('use when you need both readable text and page visuals for PPT creation, review, or analysis') — a concrete trigger phrase, matching the anchor-5 example.

5 / 5

Trigger Term Quality

Good natural-term coverage ('PDF', 'selectable text', 'tables', 'page visuals', 'PPT creation', 'Markdown') but misses common synonyms and extensions users would say — '.pdf', 'PDFs', 'convert PDF', 'screenshot'.

4 / 5

Distinctiveness Conflict Risk

Mostly a distinct niche (dual text+visual PDF-to-Markdown extraction), but the broad trigger 'PPT creation, review, or analysis' and the generic PDF-extraction framing create minor overlap risk with general PDF or presentation skills, matching anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

17

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 3 missing

Warning

Total

14

/

16

Passed

Repository

aipoch/medical-research-skills

Path

scientific-skills/Other/pdf-extract/SKILL.md

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.