CtrlK
BlogDocsLog inGet started
Tessl Logo

pdf

Read, extract, split, merge, rotate, watermark, fill, OCR, or create PDF files with verification of page counts and text extraction.

60

Quality

70%

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 ./crates/tui/assets/skills/pdf/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is concise and well-organized with verification checkpoints, but it stays at the tool-naming level rather than giving executable commands and lacks an explicit error-recovery loop for risky operations.

Suggestions

Add concrete executable examples for the most common operations, e.g. `pdftotext -layout file.pdf out.txt` or a short pdfplumber snippet, so guidance is copy-paste ready.

Extend step 5 into a feedback loop: "If page count or text extraction fails expectations, diagnose and re-run before delivering."

Include explicit commands for redaction verification (e.g. re-running pdftotext on the output to confirm removed text is gone).

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it lists tools and steps without explaining what a PDF is or how libraries work, earning the level 3 lean anchor.

3 / 3

Actionability

It names concrete tools (pdftotext, qpdf, pdfplumber, PyMuPDF) but provides no executable commands or code examples, fitting the level 2 anchor of concrete-but-incomplete guidance.

2 / 3

Workflow Clarity

The 5-step sequence includes explicit verification in step 5, but it lacks an error-recovery/fix-retry feedback loop for destructive or batch operations like redaction and merge, which the rubric wants for level 3.

2 / 3

Progressive Disclosure

Under 50 lines with no external references needed, the body is well-organized into a clear Workflow section, which the simple-skill note allows to score 3.

3 / 3

Total

10

/

12

Passed

Description

67%

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 specific and well-scoped to PDFs, but it omits an explicit "Use when..." trigger clause and a few common user phrasings, capping completeness and trigger-term quality at 2.

Suggestions

Add an explicit trigger clause, e.g. "Use when working with PDF files, PDFs, or .pdf documents, or when the user mentions forms, extraction, merging, or splitting."

Include common user synonyms like "PDFs" and ".pdf" alongside "PDF files" to improve trigger-term coverage.

DimensionReasoningScore

Specificity

Lists many concrete actions — "read, extract, split, merge, rotate, watermark, fill, OCR, or create" — matching the multi-action anchor rather than the domain-only level 2.

3 / 3

Completeness

It clearly states what the skill does but has no "Use when..." clause or equivalent explicit trigger guidance, which the rubric caps at 2.

2 / 3

Trigger Term Quality

Contains natural terms like "PDF files", "OCR", "watermark", "fill", but lacks common format variations a user would say ("PDFs", ".pdf", "forms"), so it sits at level 2 rather than 3.

2 / 3

Distinctiveness Conflict Risk

Scoped specifically to PDF operations with distinct triggers, unlikely to conflict with other skills; matches the clear-niche level 3 anchor.

3 / 3

Total

10

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Hmbown/CodeWhale
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.