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.

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/azure-ai-vision-imageanalysis-java/SKILL.md

Quality

Content

75%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 body delivers highly actionable, executable Java examples for every SDK feature with good organization and a clear implied workflow. Its main weakness is efficiency: generic filler sections (When to Use, Limitations, Trigger Phrases) and a pinned beta version add tokens without adding skill-specific value.

Suggestions

Remove the filler "When to Use" and generic "Limitations" sections (e.g., "This skill is applicable to execute the workflow or actions described in the overview") and the "Trigger Phrases" list that duplicates the frontmatter description — they add tokens without skill-specific value.

Move the per-feature code examples (Dense Captions, People, Smart Cropping, etc.) into a references/ file, keeping SKILL.md to installation, client creation, the features table, and one or two core examples, so the main file acts as a lean overview.

Drop or future-proof the pinned "1.1.0-beta.1" version (time-sensitive information), and note the need to null-check result accessors (e.g., getRead(), getCaption()) when a feature was not requested.

Dimension	Reasoning	Score
Conciseness	The code examples themselves are lean, but the body includes unnecessary padding: the vacuous "This skill is applicable to execute the workflow or actions described in the overview" section, boilerplate Limitations, a Trigger Phrases section duplicating the description, and a pinned time-sensitive version ("1.1.0-beta.1") outside any deprecated section.	3 / 5
Actionability	Every visual feature has a complete, executable Java example with imports, env-var-based client creation, and result-processing code, plus an error-handling example — copy-paste ready and covering the common cases; the only trivial gap is the undeclared `imageUrl` variable in URL-based snippets.	5 / 5
Workflow Clarity	The install → create client → analyze sequence is clear from section ordering and the Error Handling section provides a checkpoint, but validation is implicit (e.g., no guidance to null-check accessors like getRead() when a feature was not requested).	4 / 5
Progressive Disclosure	No bundle files exist, so all content is inline in a single well-organized file with clear section headers and a features table; however, ~200 lines of per-feature code examples could be split into reference files to keep SKILL.md a leaner overview.	4 / 5
	Total	16 / 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 that explicitly covers both what the skill does and when to use it, with five concrete, naturally-phrased trigger capabilities. Its only weaknesses are minor: two documented features (dense captions, people detection) are unmentioned, and a few common synonyms are absent.

Dimension	Reasoning	Score
Specificity	"image captioning, OCR text extraction, object detection, tagging, or smart cropping" lists five specific concrete actions, but omits two features the skill itself documents (dense captions, people detection), leaving minor gaps in coverage rather than comprehensive coverage.	4 / 5
Completeness	"Build image analysis applications with Azure AI Vision SDK for Java" clearly states what it does, and "Use when implementing image captioning, OCR text extraction, object detection, tagging, or smart cropping" explicitly answers when to use it with concrete trigger phrases.	5 / 5
Trigger Term Quality	Natural phrases like "image captioning", "OCR text extraction", "object detection", and "smart cropping" match what users would actually say, but common synonyms such as "computer vision", "read text from image", or "image tagging" are missing.	4 / 5
Distinctiveness Conflict Risk	"Azure AI Vision SDK for Java" carves out a clear niche, but trigger terms like "image captioning" and "object detection" could overlap with generic computer-vision or non-Java Azure Vision skills, posing minor conflict risk.	4 / 5
	Total	17 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
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-java/SKILL.md
Commit: 7b534bc

Reviewed: 5 hours 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.