azure-ai-contentsafety-java

Build content moderation applications using the Azure AI Content Safety SDK for Java.

Quality

59%

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-contentsafety-java/SKILL.md

Quality

Content

65%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 is highly actionable with comprehensive executable Java examples, but it is a monolithic reference wall with boilerplate padding and lacks validation checkpoints around destructive blocklist operations. Splitting API reference into bundle files would improve progressive disclosure.

Suggestions

Add validation/verification steps (e.g., confirm a blocklist exists before deleting, verify removal by re-listing items) for destructive blocklist operations.

Move the full blocklist management and error-handling API reference into a separate references file, keeping SKILL.md a concise overview with clearly signaled links.

Remove generic boilerplate ("When to Use", "Limitations") and the inlined "Trigger Phrases" list, folding trigger guidance into the description instead.

Dimension	Reasoning	Score
Conciseness	The code-heavy sections are lean, but generic boilerplate sections ("When to Use", "Limitations", "Trigger Phrases") pad the body with content that does not earn its tokens.	3 / 5
Actionability	Copy-paste-ready executable Java examples cover the common cases: client creation, text/image analysis, blocklist CRUD, and error handling.	5 / 5
Workflow Clarity	Destructive blocklist operations (deleteTextBlocklist, removeBlocklistItems) and batch processing lack validation checkpoints, capping workflow clarity at 3 per the rubric.	3 / 5
Progressive Disclosure	The ~290-line body has section headers but inlines a large API reference (full blocklist CRUD) that belongs in separate reference files; no bundle files or external references are signaled.	3 / 5
	Total	14 / 20 Passed

Description

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

The description names a specific SDK and language niche but states only one action and omits any explicit "when to use" trigger guidance. It is clear and distinct yet thin on coverage and trigger completeness.

Suggestions

Add 1-2 more concrete actions (e.g., analyze text/image severity, manage blocklists) to broaden capability coverage.

Append a "Use when..." clause listing natural trigger phrases users would say (e.g., "Use when moderating text or images in Java with Azure Content Safety").

Include common synonyms and file/format cues (e.g., "hate speech detection", "image moderation") to improve trigger-term quality.

Dimension	Reasoning	Score
Specificity	Names a precise domain ("Azure AI Content Safety SDK for Java") and one concrete action ("Build content moderation applications"), but coverage is not comprehensive.	3 / 5
Completeness	Has a clear "what" but no "Use when..." clause or equivalent explicit trigger guidance, capping completeness at 3 per the rubric guideline.	3 / 5
Trigger Term Quality	Includes relevant natural keywords ("content moderation", "content safety", "Azure", "Java") but misses common variations, synonyms, and file-extension cues.	3 / 5
Distinctiveness Conflict Risk	The Azure AI Content Safety + Java niche is mostly distinct with minor overlap risk against related Azure content-safety skills in other languages.	4 / 5
	Total	13 / 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/antigravity-awesome-skills
Path: skills/azure-ai-contentsafety-java/SKILL.md
Commit: 1f67c44

Reviewed: about 15 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.