← Explore all skills

CONTENT MODERATION / Microsoft

Azure AI Content Safety SDK for Java

Microsoft's Java guide to com.azure:azure-ai-contentsafety at 1.1.0-beta.1: text and image harm analysis with ContentSafetyClient, and blocklist management with BlocklistClient.

“Build content moderation applications with Azure AI Content Safety SDK for Java. Use when implementing text/image analysis, blocklist management, or harm detection for hate, violence, sexual content, and self-harm.”

01 / THE REASONING

Why this made the selection.

  • It pairs ContentSafetyClient for analysis with BlocklistClient for blocklist create or update, list, get, item add, item list, item remove and delete.
  • It states the severity scales (text 0-7 with default outputs 0, 2, 4, 6; images 0, 2, 4, 6) and shows category selection with EIGHT_SEVERITY_LEVELS output.
  • Its practice list says blocklist changes take ~5 minutes to take effect and that strict moderation typically blocks severity >= 4.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • .github/plugins/azure-sdk-java/skills/azure-ai-contentsafety-java/SKILL.md (all 297 lines)
  • .github/plugins/azure-sdk-java/README.md
  • .github/plugins/azure-sdk-java/.claude-plugin/plugin.json
  • README.md
  • LICENSE

Our findings

  • The harm categories are Hate, Sexual, Violence and Self-harm.
  • The DefaultAzureCredential sample calls requireEnvVars(AzureIdentityEnvVars.AZURE_TOKEN_CREDENTIALS) and leaves ManagedIdentityCredentialBuilder as a commented production alternative.
  • Error handling catches HttpResponseException and names InvalidRequestBody, ResourceNotFound and TooManyRequests as common codes.
  • Practice 2 says to request only the categories needed to reduce latency; practice 4 says to process items in parallel for throughput.
  • The frontmatter declares license MIT, author Microsoft, version 1.0.0 and package com.azure:azure-ai-contentsafety. It declares no allowed-tools.

Not established by this review

  • No text or image was analysed, and no blocklist or blocklist item was created, changed or removed.
  • No Maven dependency on com.azure:azure-ai-contentsafety was added to a project.
  • Neither the azure-sdk-java plugin nor azure-ai-contentsafety-java was installed, and references/examples.md was not read.
  • Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗
  1. The azure-sdk-java plugin README prints `npx skills add microsoft/skills --skill azure-sdk-java` under Install. It installs the whole azure-sdk-java plugin, whose skill table lists azure-ai-contentsafety-java; it does not install that skill alone.
  2. The same README prints `/plugin install azure-sdk-java@skills`, which also brings in azure-ai-contentsafety-java together with every other skill in the plugin. The repository README runs plugin commands inside Copilot CLI after `/plugin marketplace add microsoft/skills`.

Before you start

  • The skill gives a Maven <dependency> on com.azure:azure-ai-contentsafety version 1.1.0-beta.1, not an install command. This review added nothing.
  • CONTENT_SAFETY_ENDPOINT, plus CONTENT_SAFETY_KEY for the key samples, or AZURE_TOKEN_CREDENTIALS when DefaultAzureCredential is used in production.
  • Copilot CLI, where `/plugin install azure-sdk-java@skills` adds this Content Safety skill with the rest of the plugin.

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-java/skills/azure-ai-contentsafety-java/SKILL.md

    Supports: name, upstreamDescription, summary, whySelected, bestFor, limitations, review.findings, install.prerequisites, access.permissions

  2. https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-java/README.md

    Supports: install.sourceUrl, install.steps, limitations (install scope)

  3. https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-java/.claude-plugin/plugin.json

    Supports: publisher, license (plugin licence field)

  4. Repository README ↗Checked

    https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md

    Supports: compatibility, install.steps (Copilot CLI plugin commands)

  5. Repository LICENSE ↗Checked

    https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE

    Supports: license

  6. https://github.com/microsoft/skills/commit/e7ee58fc1fa669841e06f8d27359e0533d148394

    Supports: limitations (last commit date)

Evidence & Ask