Skip to main content
skill CX Codex

azure-content-safety — Claude Code skill: what it does, how to install

azure-content-safety — a skill for Azure AI Content Safety development: text and image moderation, blocklist setup, groundedness checks, and prompt injection defense.

CC-BY-4.0 180 installs ★ 818 updated 2026-11-09

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MicrosoftDocs/Agent-Skills --skill azure-content-safety -a claude-code
Open on GitHub

What azure-content-safety does

The skill gives the agent access to Azure AI Content Safety documentation: threshold tuning, false positive reduction, Docker container deployment, and content moderation API calls. It includes a category index (troubleshooting, limits, security, integrations) with links to Microsoft Learn pages, fetched via the mcp_microsoftdocs MCP server or fetch_webpage fallback.

Covers text blocklist configuration, custom moderation categories, groundedness detection for LLM outputs, prompt attack detection with Prompt Shields, and multimodal content analysis. The skill requires network access to retrieve up-to-date documentation. When the generation timestamp is over three months old, the agent will suggest updating the skill from the repository.

What it helps with

  • diagnose Azure AI Content Safety API error codes
  • tune moderation thresholds and cut down false positives
  • deploy a Content Safety or Prompt Shields container on-premises
  • integrate groundedness detection for model responses
  • detect prompt injections using the Prompt Shields API

Example prompts for the agent

  • Show me how to set up a text blocklist in azure-content-safety
  • Explain the limits and quotas for Content Moderator image lists
  • Walk me through deploying the Content Safety Docker container with configuration parameters

How to install azure-content-safety

1Skills CLI (Vercel)

npx skills add MicrosoftDocs/Agent-Skills --skill azure-content-safety -a claude-code

2Manually: put the files in place

~/.claude/skills/azure-content-safety/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/azure-content-safety/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about azure-content-safety

How to install azure-content-safety in Claude Code?

Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-content-safety -a claude-code, the skill file will appear at ~/.claude/skills/azure-content-safety/SKILL.md.

What does azure-content-safety do?

The skill connects the agent to Azure AI Content Safety documentation: text and image moderation setup, groundedness API, prompt attack detection, container deployment, and service limits and quotas.

What does azure-content-safety need to work?

Network access and the mcp_microsoftdocs MCP server to fetch documentation. If the server is unavailable, the skill falls back to fetch_webpage. Calling the actual Content Safety APIs requires an Azure subscription key.

Source text

SKILL.md · CC-BY-4.0
---
name: azure-content-safety
description: Expert knowledge for Content Safety in Foundry Control Plane development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Content Safety/Prompt Shields APIs, Docker containers, text blocklists, custom categories, or groundedness checks, and other Content Safety in Foundry Control Plane related development tasks. Not for Azure Content Understanding in Foundry Tools (use azure-content-understanding), Azure Speech in Foundry Tools (use azure-speech), Azure Security (use azure-security), Azure Sentinel (use azure-sentinel).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-11-08"
  generator: "docs2skills/1.0.0"
---
# Content Safety in Foundry Control Plane Skill

This skill provides expert guidance for Content Safety in Foundry Control Plane. Covers troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

## How to Use This Skill

> **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file

> **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)

This skill requires **network access** to fetch documentation content:
- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.
- **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.

## Category Index

| Category | Lines | Description |
|----------|-------|-------------|
| Troubleshooting | L36-L40 | Diagnosing and resolving Azure AI Content Safety API errors, including HTTP status codes, common failure causes, and recommended fixes or retries. |
| Best Practices | L41-L45 | Tuning Content Safety thresholds, categories, and prompts to reduce misclassifications, plus strategies to balance safety, recall, and user experience. |
| Decision Making | L46-L51 | Guidance on migrating apps from Content Safety preview to GA and deciding when and how to use limited-access Content Safety features and models. |
| Limits & Quotas | L52-L59 | Limits, quotas, and regional caps for Content Safety/Moderator (image & term lists, custom categories, code protected-material checks) and how to configure or stay within them. |
| Security | L60-L64 | Details on how Azure AI Content Safety encrypts data at rest, including encryption models, key management options, and compliance/security considerations. |
| Configuration | L65-L71 | Configuring and running Azure AI Content Safety and Prompt Shields Docker containers, and setting up/using text blocklists to filter unsafe or disallowed content. |
| Integrations & Coding Patterns | L72-L81 | Patterns and code samples for calling Content Safety/Prompt Shields APIs, defining custom categories, detecting groundedness, provenance, and multimodal (text/image/media) safety signals. |
| Deployment | L82-L87 | How to deploy and run Azure Content Safety text/image analysis containers on-premises with Docker, including setup, configuration, and runtime considerations. |

### Troubleshooting
| Topic | URL |
|-------|-----|
| Resolve Azure AI Content Safety API error codes | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/concepts/response-codes |

### Best Practices
| Topic | URL |
|-------|-----|
| Reduce false positives and negatives in Content Safety | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/improve-performance |

### Decision Making
| Topic | URL |
|-------|-----|
| Migrate apps from Content Safety preview to GA | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/migrate-to-general-availability |
| Decide when to use limited access Content Safety features | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/limited-access |

### Limits & Quotas
| Topic | URL |
|-------|-----|
| Apply image list quotas in Content Moderator | https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/image-lists-quickstart-dotnet |
| Understand Content Moderator image and term list limits | https://learn.microsoft.com/en-us/azure/ai-services/content-moderator/samples-dotnet |
| Use protected material detection for code outputs | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/quickstart-protected-material-code |
| Review Azure AI Content Safety regional limits | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/region-availability |

### Security
| Topic | URL |
|-------|-----|
| Understand data-at-rest encryption in Content Safety | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/encrypt-data-at-rest |

### Configuration
| Topic | URL |
|-------|-----|
| Configure and run Azure AI Content Safety Docker containers | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/containers/install-run-container |
| Configure and run Azure Content Safety Prompt Shields container | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/containers/prompt-shields-container |
| Configure and use text blocklists in Content Safety | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/use-blocklist |

### Integrations & Coding Patterns
| Topic | URL |
|-------|-----|
| Implement custom categories (rapid) Content Safety API | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/custom-categories-rapid |
| Use Content Provenance Detection API for media | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/how-to-provenance-detection |
| Use Azure Content Safety custom categories API | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/quickstart-custom-categories |
| Call Azure Content Safety groundedness detection API | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/quickstart-groundedness |
| Call Prompt Shields API to detect prompt attacks | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/quickstart-jailbreak |
| Integrate multimodal analysis with Content Safety | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/quickstart-multimodal |

### Deployment
| Topic | URL |
|-------|-----|
| Deploy and run Azure Content Safety containers on-premises | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/containers/container-overview |
| Deploy image analysis Content Safety container with Docker | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/containers/image-container |
| Deploy text analysis Content Safety container with Docker | https://learn.microsoft.com/en-us/azure/ai-services/content-safety/how-to/containers/text-container |

© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills

Similar skills

All skills for Cloud: AWS, Azure, GCP →

From the same set144

The whole set →
azure-queue-storage Guides coding agents through Azure Queue Storage tasks, including Entra ID security, service limits, monitoring setup, and SDK usage across multiple languages. CX Codex +1 181installs azure-portal This skill gives your agent knowledge about Azure Portal: access control, security policies, dashboard configuration, and troubleshooting. Install it if you manage portal settings, handle access issues, or work with Azure mobile apps. CX Codex +1 181installs azure-copilot Skill for Azure Copilot work: VM sizing, Bicep and Terraform generation, Cosmos DB setup for chat storage, Azure network design. CX Codex +1 180installs azure-bot-service azure-bot-service — a skill for Azure AI Bot Service development. Provides expert guidance on channel setup, Direct Line 3.0, security, deployment, and debugging issues in the Bot Framework. CX Codex +1 180installs azure-firewall-manager Guides Azure Firewall Manager configuration, security policies, and architectural choices. Useful when setting up secured virtual hubs, DDoS plans, or WAF. CX Codex +1 180installs azure-traffic-manager Expert skill for Azure Traffic Manager: traffic routing, profile architecture, IaC with ARM/Bicep/Terraform. Covers endpoint configuration, routing methods, and troubleshooting degraded profiles. CX Codex +1 178installs azure-maps A skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that brings Azure Maps expertise into the agent context. Covers geocoding, routing, traffic, weather tiles, security patterns, and Web/REST SDK integration. CX Codex +1 178installs azure-aks-edge-essentials azure-aks-edge-essentials — a skill for Claude Code helps troubleshoot and configure AKS Edge Essentials and AKS Arc clusters on Windows Server. Resolves cluster recovery issues, network routing, and Arc onboarding. CX Codex +1 177installs

Project sponsors

Companies that keep this analytics open