CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

paperkit

Add drawings, shapes, and a consistent markup experience using PaperKit. Use when integrating PaperMarkupViewController for markup editing, adding shape recognition, working with PaperMarkup data models, embedding markup tools in document editors, or building annotation features that need the system-standard markup toolbar. New in iOS 26.

Quality

90%

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

The canonical home for this skill is dpearson2699/swift-ios-skills

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.

Excellent body content: executable Swift examples covering the common integration cases, a clearly sequenced workflow with validation and failure-recovery loops, and a clean one-level-deep split between the SKILL.md overview and the patterns reference. The only minor issue is small duplicated tool-picker wiring and a slightly discursive PencilKit-integration paragraph.

DimensionReasoningScore

Conciseness

Dense and API-focused with no padding explaining concepts Claude already knows, but there is minor redundancy that could be trimmed: PKToolPicker wiring appears nearly identically in both 'Basic UIKit Setup' and 'Tool Picker Setup', the Contents list duplicates section headers, and the Integration with PencilKit prose is slightly discursive. Anchor 4 ('efficient; minor instances that could be trimmed') fits better than 5.

4 / 5

Actionability

Fully executable, copy-paste-ready code throughout: a complete UIKit view controller with delegate wiring, an async save function, programmatic insertion of text/image/shape/line with real ShapeConfiguration values, FeatureSet customization, HDR settings, and a complete SwiftUI UIViewControllerRepresentable bridge. Matches anchor 5 ('fully executable; copy-paste ready; specific examples cover the common cases').

5 / 5

Workflow Clarity

The numbered 5-step workflow sequences design decisions through construction, saving, and round-trip testing, includes explicit validation ('test round-trip loading with the same feature set'), a feedback loop for error recovery ('On failure, restore the original document bytes, fix the feature-set/version/controller mismatch, and rerun edit, save, relaunch, load, thumbnail fallback, and undo checks'), and a 10-item Review Checklist. Matches anchor 5's 'explicit validation steps; feedback loops; checklists'.

5 / 5

Progressive Disclosure

SKILL.md stays a core overview (setup, key APIs, common cases) while extended patterns are one level deep in references/paperkit-patterns.md (verified present, well-organized with its own contents index), clearly signaled twice with an explicit statement of what it contains ('full platform setup, tool picker wiring, persistence, thumbnails, custom feature sets, programmatic construction, and migration'). Matches anchor 5 ('clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation').

5 / 5

Total

19

/

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.

A strong description with an explicit and detailed 'Use when' trigger clause and concrete API-level actions. Its main weaknesses are a vague phrase ('a consistent markup experience'), some missing natural synonyms, and mild overlap with the sibling PencilKit skill on generic drawing terms.

Suggestions

Replace 'a consistent markup experience' with concrete capability nouns such as text boxes, images, lines, and shape fills/stickers to close the coverage gaps and remove the vague phrase.

Add a natural synonym or two users would actually say, such as 'annotations' or 'annotating documents/PDFs', to improve trigger term coverage.

Distinguish the trigger terms from the sibling PencilKit skill (e.g., 'structured markup and shapes on top of documents' vs. freeform PencilKit drawing) to reduce overlap risk on generic 'drawing' terms.

DimensionReasoningScore

Specificity

Lists several concrete, API-anchored actions ('integrating PaperMarkupViewController for markup editing, adding shape recognition, working with PaperMarkup data models, embedding markup tools in document editors, or building annotation features'), but 'a consistent markup experience' is vague padding and coverage has gaps (no mention of text, images, stickers, or persistence/thumbnails). Fits anchor 4 rather than 5 for these gaps, and well above anchor 3 given multiple specific actions.

4 / 5

Completeness

Explicitly answers both questions: the 'what' ('Add drawings, shapes, and a consistent markup experience using PaperKit') and an explicit 'Use when...' clause with five concrete trigger phrases covering integration, shape recognition, data models, document editors, and annotation toolbars. Clearly matches the anchor 5 example structure.

5 / 5

Trigger Term Quality

Good natural-keyword coverage: 'drawings', 'shapes', 'markup', 'markup editing', 'annotation features', 'shape recognition', 'markup toolbar' are phrases an iOS developer would naturally say. A few natural terms are missing (e.g., 'annotations' as a standalone word, 'text boxes', and no mention of PencilKit as the related drawing technology), so it does not reach anchor 5's comprehensiveness.

4 / 5

Distinctiveness Conflict Risk

Distinct niche (PaperKit APIs, 'New in iOS 26') with specific class names as triggers, but generic terms like 'drawings'/'drawing' overlap with the closely related pencilkit skill mentioned in the body. Minor overlap risk with a closely related skill matches anchor 4 rather than 5's 'minimal conflict risk'.

4 / 5

Total

17

/

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

dpearson2699/swift-ios-skills

Path

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