CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

65

Quality

79%

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 ./skills/azure-ai-vision-imageanalysis-py/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 content is highly actionable — every operation has complete, executable code — and well-organized by section. It is held back by inlined reference material that belongs in a separate examples/API file (260 lines in one file, no progressive disclosure) and by generic boilerplate sections that add tokens without adding guidance.

Suggestions

Move the per-feature code examples (Image Caption, Dense Captions, Tags, Object Detection, OCR, People Detection, Smart Cropping) into an examples or API reference file and keep only a quick-start snippet plus the Visual Features table in SKILL.md, with clearly signaled one-level-deep links.

Delete the generic "When to Use" filler ("This skill is applicable to execute the workflow or actions described in the overview.") and the boilerplate Limitations text; replace with skill-specific guidance (e.g., Azure region requirements, pricing tier notes) only if actionable.

Consolidate the seven near-identical analyze_from_url calls into one parameterized pattern and note per-feature result attributes in the Visual Features table, cutting repetition while preserving the excellent actionability.

DimensionReasoningScore

Conciseness

The body is dominated by executable code with minimal explanatory prose, but contains boilerplate filler ("This skill is applicable to execute the workflow or actions described in the overview.") and seven near-identical per-feature call patterns that repeat the same analyze_from_url structure. Efficient with minor instances that could be trimmed fits anchor 4, not the every-token-earns-its-place level of 5.

4 / 5

Actionability

Every section provides copy-paste-ready, executable Python covering installation, environment setup, both authentication methods, all seven visual features, the async client, and HttpResponseError handling. This matches the fully-executable, common-cases-covered anchor exactly, and there are no gaps that would lower it to 4.

5 / 5

Workflow Clarity

The setup-to-usage sequence (Installation → Environment Variables → Authentication → analysis examples) is coherent and error handling is demonstrated, but there are no explicit validation checkpoints or feedback guidance (e.g., verify feature support or retry on failure). Clear sequence with most checkpoints present fits anchor 4; it is not capped at 3 because no destructive or batch operations are instructed, and not 5 because explicit validation/feedback loops are absent.

4 / 5

Progressive Disclosure

Everything lives in a single ~260-line SKILL.md with no references or bundle files; the seven per-feature API examples and the Visual Features table are reference material inlined into the overview. Some structure but content that should be separate is inline fits anchor 3 — not 4, since nothing is split out or clearly signaled as external, and clearly not 2 because the section organization itself is good.

3 / 5

Total

16

/

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: it names six concrete capabilities and includes an explicit use-when clause in third-person voice without padding. Its main weaknesses are a generic trigger clause and missing natural synonyms ("analyze images", "describe an image", "object detection") that would sharpen both completeness and distinctiveness.

DimensionReasoningScore

Specificity

"captions, tags, objects, OCR, people detection, and smart cropping" lists multiple concrete capabilities with near-comprehensive coverage of the SDK's visual features (only dense captions is omitted). This matches the anchor for multiple specific concrete actions, and the single omission is not a meaningful coverage gap that would drop it to 4.

5 / 5

Completeness

The what is clear (SDK for six named capabilities) and an explicit "Use for computer vision and image understanding tasks" clause answers when, but the when-clause is generic rather than concrete trigger phrases (e.g., "when the user mentions..."). This sits squarely at anchor 4: both present, when could be more specific — not 3 because the trigger guidance is explicit, not merely implied.

4 / 5

Trigger Term Quality

Natural terms like "computer vision", "image understanding", "OCR", and "Image Analysis" are present and would be said by users, but common variations such as "analyze images", "describe an image", or "object detection" are missing. Good keyword coverage with a few natural terms missing fits anchor 4, not the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The first sentence anchors the skill to a specific niche (Azure AI Vision Image Analysis SDK), but the broad "computer vision and image understanding tasks" trigger could overlap with general image-processing or other vision skills. Mostly distinct with minor overlap risk fits anchor 4; it is not 5 because the trigger clause is not tightly scoped to Azure or image analysis specifically.

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