CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-ai-vision-imageanalysis-py

Azure AI Vision Image Analysis SDK for captions, tags, objects, OCR, people detection, and smart cropping. Use for computer vision and image understanding tasks.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 highly actionable, well-structured SDK reference whose code examples are executable and cover the common cases, with clear setup ordering and error-handling feedback. Its weaknesses are repeated call boilerplate across the per-feature examples, a filler 'When to Use' section, and no use of separate reference files to keep the main body lean.

Suggestions

Remove the boilerplate 'When to Use' and generic 'Limitations' filler sections, or replace them with skill-specific guidance that earns their tokens.

Compress the per-feature examples by stating the analyze_from_url call once and showing only the result-parsing loop per feature, or move per-feature detail into a reference file (e.g. references/features.md) to keep SKILL.md a lean overview.

DimensionReasoningScore

Conciseness

The body is almost entirely executable code with no explanations of known concepts, but the analyze_from_url call boilerplate repeats across eight nearly identical blocks, and the "When to Use" section ("This skill is applicable to execute the workflow or actions described in the overview") plus generic Limitations bullets read as filler. This matches 'efficient; minor instances that could be trimmed' rather than the every-token-earns-its-place anchor.

4 / 5

Actionability

Fully executable, copy-paste-ready code covers the common cases: both API-key and Entra ID auth, URL and file input, per-feature result parsing, the async client, and HttpResponseError handling. This matches the top anchor for executable guidance covering common cases.

5 / 5

Workflow Clarity

This is a single-task skill (call analyze with selected visual_features) and the action is unambiguous; the simple-skill exception applies. The setup sequence (install, env vars, auth) is clear, error handling provides a feedback loop ("except HttpResponseError" with status/reason/message), and the boundary section adds an explicit checkpoint ("Review output before consequential use"). No destructive or batch cap applies to this read-only analysis API.

5 / 5

Progressive Disclosure

Sections are well organized with a features table and logical order, but no bundle files exist and roughly 200 lines of per-feature API usage are fully inlined where a reference file could hold the detail. This fits 'good structure; most content appropriately placed; minor organization gaps'; the under-50-line no-references exception does not apply at ~265 lines, ruling out the top anchor.

4 / 5

Total

18

/

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 SDK and enumerates its concrete capabilities with an explicit use clause, written in appropriate third-person style. Its main weakness is a generic when-clause and missing natural trigger synonyms, which leave minor overlap risk with other vision-related skills.

Suggestions

Make the when-clause concrete with trigger phrases, e.g. "Use when the user mentions image analysis, describing or captioning images, OCR/text extraction from images, or detecting objects and people in photos".

Add natural synonyms users would say, such as "object detection", "image tagging", "text extraction from images", or "analyze image", to strengthen trigger matching.

DimensionReasoningScore

Specificity

Enumerates six concrete capabilities ("captions, tags, objects, OCR, people detection, and smart cropping") for a named SDK, matching the comprehensive multi-action anchor. Score 4 would require minor coverage gaps, but the list spans all major features of the service.

5 / 5

Completeness

Clearly answers 'what' (SDK for the listed features) and has an explicit when-clause ("Use for computer vision and image understanding tasks"). The when-clause is generic domain language rather than concrete trigger phrases, so it fits the 'both present but when could be more explicit' anchor, not the concrete-trigger-phrase anchor.

4 / 5

Trigger Term Quality

Natural terms like "OCR", "computer vision", "people detection", and "smart cropping" are present, but common synonyms ("describe an image", "text extraction from images", "object detection") and file extensions are missing. This matches the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive synonym/extension anchor.

4 / 5

Distinctiveness Conflict Risk

The named SDK and specific feature list establish a clear niche, but "Use for computer vision and image understanding tasks" is broad enough to overlap with other image/vision-related skills. This is 'mostly distinct; minor overlap risk', short of the minimal-conflict anchor whose when-clause itself carries distinct triggers.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

sickn33/agentic-awesome-skills

Path

skills/azure-ai-vision-imageanalysis-py/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.