CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pdfkit

Display and manipulate PDF documents using PDFKit. Use when embedding PDFView to show PDF files, creating or modifying PDFDocument instances, adding annotations (highlights, notes, signature widgets), extracting text with PDFSelection, navigating pages, generating thumbnails, filling PDF forms, or wrapping PDFView in SwiftUI.

Quality

91%

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

86%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 a well-structured overview that keeps non-obvious invariants and WRONG/CORRECT examples up front while correctly offloading implementation recipes to three real, one-level-deep reference files. Weaknesses are minor: some duplication between Core Decisions, Common Mistakes, and the Review Checklist, and no error-recovery loop around document saving.

DimensionReasoningScore

Conciseness

The body is lean with no beginner padding and every code snippet targets a real gotcha, but 'Core Decisions' restates the Common Mistakes in prose and the References section re-lists the same files already routed in 'Route by Task' — minor trimmable redundancy that fits anchor 4 rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Each Common Mistake gives copy-paste-ready WRONG/CORRECT Swift covering the common failure cases (failable init, autoScales, coordinate conversion, main-actor mutation, identity check), and the Review Checklist names specific APIs — fully executable guidance matching anchor 5.

5 / 5

Workflow Clarity

The 5-step Workflow is clearly sequenced and includes an explicit verification step ('verify reload, rotation, large files, protected files, and annotation persistence') plus a review checklist, but it lacks a validate-then-fix feedback loop for failed saves, so it fits anchor 4 rather than anchor 5.

4 / 5

Progressive Disclosure

The entrypoint is a concise overview with three one-level-deep reference files that all exist in the bundle, each clearly signaled with task-based routing ('Read [core implementation details]… for loading, viewing, navigation…'), matching the well-signaled-references anchor 5.

5 / 5

Total

18

/

20

Passed

Description

92%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 description: it states concrete capabilities and an explicit, enumerated 'Use when' trigger clause tied to specific PDFKit APIs. The only notable gap is the absence of the '.pdf' extension and the 'PDFs' synonym in its trigger terms.

DimensionReasoningScore

Specificity

The description lists many concrete actions — 'embedding PDFView', 'creating or modifying PDFDocument instances', 'adding annotations (highlights, notes, signature widgets)', 'extracting text with PDFSelection', 'generating thumbnails', 'filling PDF forms', 'wrapping PDFView in SwiftUI' — matching the comprehensive-coverage anchor rather than anchor 4, which requires minor gaps.

5 / 5

Completeness

It clearly states what the skill does ('Display and manipulate PDF documents using PDFKit') and gives an explicit 'Use when…' clause with concrete trigger phrases, matching the anchor-5 example pattern; it is not anchor 4 because the 'when' is specific and enumerated rather than generic.

5 / 5

Trigger Term Quality

Good natural keyword coverage ('PDF files', 'forms', 'annotations', 'highlights', 'thumbnails', 'navigating pages') but it omits common synonyms and file extensions like 'PDFs' and '.pdf', so it fits anchor 4 ('a few natural terms missing') rather than anchor 5.

4 / 5

Distinctiveness Conflict Risk

Naming PDFKit and its specific classes (PDFView, PDFDocument, PDFSelection) plus SwiftUI establishes a clear niche with distinct triggers and minimal overlap with other document skills, matching anchor 5.

5 / 5

Total

19

/

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

thienqo/ios-skills

Path

skills/pdfkit/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.