CtrlK
BlogDocsLog inGet started
Tessl Logo

azure-ai-contentunderstanding-py

Azure AI Content Understanding SDK for Python. Use for multimodal content extraction from documents, images, audio, and video.

61

Quality

72%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/antigravity-azure-ai-contentunderstanding-py/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 SDK reference with executable examples for every operation and a clear core workflow, though with mild redundancy across the per-media-type examples. Its structure is clean but monolithic — API-detail content is inlined rather than split into reference files.

Suggestions

Deduplicate the four analyze examples into one canonical pattern plus a short per-media-type table of analyzer_id and result-access differences, and drop the generic 'When to Use' and 'Limitations' boilerplate.

Move API-detail sections (Model Imports, Client Types, Content Types, and the full custom-analyzer field-schema example) into a references/ file linked from SKILL.md to reduce always-loaded tokens.

Add a brief error-handling note to the Core Workflow (e.g., catching failed poller results and retrying) to close the validation gap for long-running operations.

DimensionReasoningScore

Conciseness

The body is mostly lean code with minimal concept explanation, but includes unnecessary padding: import blocks are repeated across the four analyze examples, the Image and Audio sections are near-duplicates of the Document pattern, and the 'When to Use' and 'Limitations' sections are generic boilerplate ('This skill is applicable to execute the workflow or actions described in the overview'). This matches 'mostly efficient but could be tightened' rather than the minor-trim level above.

3 / 5

Actionability

Every section provides copy-paste-ready executable code — installation, auth, all four media types via begin_analyze/poller.result(), a complete custom-analyzer field schema, analyzer management, and a full async example — covering the common cases exactly as the top anchor requires.

5 / 5

Workflow Clarity

'Core Workflow' gives a clear three-step sequence (begin_analyze → poller.result() → process contents) and long-running duration is flagged in Best Practices, but there is no error handling or validation of failed analyses — matching 'clear sequence with most checkpoints; minor validation gaps.' The destructive/batch cap does not apply since the core workflow is non-destructive analysis.

4 / 5

Progressive Disclosure

The body is well-sectioned with clear headers, but no bundle files exist and all ~275 lines are inlined in SKILL.md, including API-detail material (Model Imports, Client Types, Content Types tables, the full custom-analyzer schema) that belongs in one-level-deep reference files — matching 'some structure but content that should be separate is inline.'

3 / 5

Total

15

/

20

Passed

Description

73%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 concise, third-person description that clearly identifies a distinct niche and includes an explicit 'Use for' clause. Its main weaknesses are that it names only one capability (content extraction) and the trigger clause restates the capability rather than giving distinct, concrete trigger phrases.

Suggestions

Mention one or two additional concrete capabilities in the description (e.g., transcribing audio/video with timestamps, building custom analyzers with field schemas) to lift specificity.

Differentiate the trigger clause from the capability statement, e.g., 'Use when the user mentions Azure Content Understanding, needs to extract content or transcribe documents, images, audio, or video files, or asks about prebuilt analyzers.'

DimensionReasoningScore

Specificity

Names the domain ('Azure AI Content Understanding SDK for Python') and one concrete action ('multimodal content extraction from documents, images, audio, and video'), but stops at a single capability — no mention of transcription, field extraction, or custom analyzers that the skill actually covers, so it matches the '1-2 concrete actions, not comprehensive' anchor rather than the 'several specific actions' level above.

3 / 5

Completeness

Both 'what' (multimodal content extraction SDK) and 'when' ('Use for multimodal content extraction from...') are present, and the explicit 'Use for' clause avoids the cap at 3; however the 'when' clause merely restates the 'what' rather than offering concrete trigger phrases, matching the 'when could be more explicit' anchor instead of the level above.

4 / 5

Trigger Term Quality

'multimodal content extraction' plus 'documents, images, audio, and video' are natural terms users would say, giving good keyword coverage; a few common variations are missing (e.g., 'transcribe', 'OCR', file extensions like .pdf/.mp4), which keeps it below the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

It names a specific Azure SDK with a clear niche ('Azure AI Content Understanding SDK for Python') and medium-specific triggers, making it clearly distinguishable from generic document/PDF skills with minimal conflict risk — matching the top anchor.

5 / 5

Total

16

/

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
boisenoise/skills-collections
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.