azure-ai-vision-imageanalysis-java

Build image analysis applications with Azure AI Vision SDK for Java. Use when implementing image captioning, OCR text extraction, object detection, tagging, or smart cropping.

1.28x

Quality

78%

Does it follow best practices?

Impact

100%

1.28x

Average score across 3 eval scenarios

Securityby

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/azure-ai-vision-imageanalysis-java/SKILL.md

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong skill description that clearly identifies the technology (Azure AI Vision SDK for Java), lists specific capabilities, and includes an explicit 'Use when' clause with natural trigger terms. It follows third-person voice conventions and is concise without being vague. The description would effectively differentiate this skill from other image processing or Azure-related skills.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: image captioning, OCR text extraction, object detection, tagging, and smart cropping. Also specifies the technology stack (Azure AI Vision SDK for Java).	3 / 3
Completeness	Clearly answers both 'what' (build image analysis applications with Azure AI Vision SDK for Java) and 'when' (explicit 'Use when' clause listing specific triggers: implementing image captioning, OCR text extraction, object detection, tagging, or smart cropping).	3 / 3
Trigger Term Quality	Includes strong natural keywords users would say: 'image analysis', 'Azure AI Vision', 'image captioning', 'OCR', 'text extraction', 'object detection', 'tagging', 'smart cropping', and 'Java'. These cover common variations of how users would describe these tasks.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive due to the specific combination of Azure AI Vision SDK, Java, and the enumerated computer vision tasks. Unlikely to conflict with generic image processing skills or other cloud provider vision APIs.	3 / 3
	Total	12 / 12 Passed

Implementation

57%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill excels at actionability with complete, executable Java code examples for every Azure AI Vision feature. However, it suffers from being a monolithic reference document that could benefit significantly from progressive disclosure—splitting detailed per-feature examples into a separate file. The workflow clarity is adequate for individual API calls but lacks guidance on error recovery patterns and validation steps for production use.

Suggestions

Split individual feature examples (Objects, Tags, People, Smart Crops, Dense Captions) into a separate EXAMPLES.md or REFERENCE.md, keeping only the most common patterns (Caption, OCR, Multiple Features) in SKILL.md with links to the detailed file.

Add a brief workflow section showing the recommended sequence: verify region support → create client → test with simple caption → implement desired features → add error handling, with validation checkpoints.

Remove the 'Trigger Phrases' and 'When to Use' boilerplate sections which waste tokens and provide no actionable guidance.

Reduce boilerplate repetition across examples by showing the import/setup once and noting 'same client setup as above' for subsequent examples.

Dimension	Reasoning	Score
Conciseness	The skill is mostly efficient with executable code examples, but includes some unnecessary sections like 'Trigger Phrases' and 'When to Use' which add no value. The Visual Features table descriptions are somewhat redundant given the self-explanatory code examples. Each feature gets its own full code block which creates some repetition in the boilerplate.	2 / 3
Actionability	Every feature is demonstrated with fully executable, copy-paste ready Java code including proper imports, client creation, and result processing. The Maven dependency, environment variables, and image requirements provide complete setup guidance.	3 / 3
Workflow Clarity	The skill presents individual feature examples clearly but lacks a cohesive workflow sequence. There's basic error handling shown but no validation checkpoints or feedback loops for common failure scenarios like invalid endpoints, unsupported image formats, or region availability issues. The regional availability note is mentioned but not integrated into a workflow.	2 / 3
Progressive Disclosure	The content is a monolithic wall of code examples with no references to external files. At ~200 lines, the individual feature examples (Caption, OCR, Objects, Tags, People, Smart Crops, Dense Captions) could be split into a reference file, keeping SKILL.md as a concise overview with the most common patterns and links to detailed examples.	1 / 3
	Total	8 / 12 Passed

Validation

90%

Warnings & errors only

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

Validation — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Repository: sickn33/antigravity-awesome-skills
Commit: dacd52e

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.