CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vision-framework

Implement computer vision features including text recognition (OCR), face detection, barcode scanning, image segmentation, object tracking, and document scanning in iOS apps. Covers both the modern Swift-native Vision API (iOS 18+) and legacy VNRequest patterns, VisionKit DataScannerViewController for live camera scanning, and CoreMLRequest/VNCoreMLRequest for custom model inference. Use when adding OCR, barcode scanning, face detection, or custom Core ML model inference with Vision.

Quality

84%

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

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

A well-organized, code-dense reference that cleanly separates modern and legacy API generations and leans on real, existing reference files for deep detail. The main improvement opportunities are pushing the remaining legacy inline code and the request-type catalog into the reference file and replacing placeholder comments with concrete property access.

Suggestions

Move the 14-row 'Other Request Types' catalog and the full legacy VNGeneratePersonInstanceMaskRequest code block into references/vision-requests.md, keeping only a pointer in SKILL.md — both are reference-depth material inlined in the overview.

Replace placeholder comments like 'for table in container.tables { /* structured table data */ }' with the actual property access (e.g., table.text or row/column accessors) so the document-scanning example is fully executable.

Trim overlap between the Common Mistakes section and the Review Checklist by folding purely restated items (coordinate conversion, recognition level, symbology limiting) into one location.

DimensionReasoningScore

Conciseness

The body is code-first with no basic-concept padding (it never explains what Vision or OCR is) and version-sensitive material is properly quarantined into modern/legacy sections and a Common Mistakes format. It falls short of a 5 because of trimmable material: placeholder-comment loops in the Document Scanning example ('/* structured table data */'), and some redundancy between the Review Checklist and Common Mistakes sections.

4 / 5

Actionability

Most guidance is executable Swift with imports, real property names, and complete call chains (the OCR function, face/landmark requests, tracking loop, DataScannerViewController quick start). It is not a 5 because of minor gaps: several snippets reference undefined context values (cgImage, framePixelBuffers) and the document-scanning and table/list sections use placeholder comments instead of concrete property access.

4 / 5

Workflow Clarity

The skill's workflow — choose an API generation by deployment target (decision table up front), configure the request for the use case (recognition/quality level guidance, symbology limiting, availability checks), perform it, then verify — is clearly sequenced, and the 13-item Review Checklist plus DON'T/DO/Why Common Mistakes provide explicit validation checkpoints. There are no destructive or batch operations, so no cap applies, and the single-pattern-per-request structure is unambiguous.

5 / 5

Progressive Disclosure

The body is a clear overview with a Contents TOC, and both referenced files exist and are one level deep, each link justified by context ('Load references/vision-requests.md for complete legacy request and handler patterns'). It stays at 4 rather than 5 because some content that belongs in the reference files is inlined: the full legacy instance-mask code block and the 14-row 'Other Request Types' table.

4 / 5

Total

17

/

20

Passed

Description

80%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 that names the domain, enumerates concrete capabilities and specific APIs in third-person voice, and closes with an explicit 'Use when...' trigger clause. Its only weaknesses are a trigger list that covers a subset of the advertised capabilities and a few missing natural synonyms (QR code, pose detection).

DimensionReasoningScore

Specificity

The description enumerates multiple concrete capabilities ('text recognition (OCR), face detection, barcode scanning, image segmentation, object tracking, and document scanning') and grounds them in specific APIs ('VisionKit DataScannerViewController', 'CoreMLRequest/VNCoreMLRequest', 'modern Swift-native Vision API (iOS 18+) and legacy VNRequest patterns'). Coverage is comprehensive across the skill's domain, matching the anchor for multiple specific concrete actions rather than the score-4 anchor's 'minor gaps'.

5 / 5

Completeness

Both questions are answered: the 'what' is concrete ('Implement computer vision features including... in iOS apps. Covers both the modern Swift-native Vision API... and legacy VNRequest patterns') and a 'when' clause exists ('Use when adding OCR, barcode scanning, face detection, or custom Core ML model inference with Vision'). It sits at 4 rather than 5 because the trigger list omits several of the stated capabilities (image segmentation, object tracking, document scanning), making the 'when' slightly less exhaustive than the 'what'.

4 / 5

Trigger Term Quality

Natural trigger phrases are present ('OCR', 'face detection', 'barcode scanning', 'Core ML model inference with Vision'), which users would commonly say. A few natural variations are missing — e.g., 'QR code', 'text recognition', or 'pose detection' — so it falls at 'good keyword coverage; a few natural terms missing' rather than comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The description is firmly niched to iOS Vision/VisionKit with distinctive API names, so it is 'mostly distinct'. Minor overlap remains with a hypothetical coreml skill since it advertises 'custom Core ML model inference', keeping it below the clear-niche anchor.

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/vision-framework/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.