# Validate Microsoft Foundry Hosted Agent

> Validate one Microsoft Foundry hosted agent against Microsoft Foundry best practices and open its validation report. Use when the user explicitly asks to validate a Foundry hosted agent or invokes this skill.

- Skill: `microsoft/validate-microsoft-foundry-hosted-agent` (Agent Skill)
- Install (CLI): `npx skillmds@latest add microsoft/validate-microsoft-foundry-hosted-agent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/microsoft/validate-microsoft-foundry-hosted-agent/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Microsoft (https://skillmd.com/u/microsoft)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/microsoft/validate-microsoft-foundry-hosted-agent

---


# Validate a Microsoft Foundry hosted agent

Treat the slash-command input as free-form validation input:

1. Use its `agentPath`, or the current working directory when none is supplied. Preserve `rulesFile` and other input.
2. Load the `microsoft-foundry` skill and follow `foundry-agent/validate/validate.md`. Pass `agentPath` as the only target context; the canonical workflow selects and validates one hosted agent.
3. If the workflow returns `no-hosted-agent`, ask once for a direct path and retry. Stop if the user provides no path or the retry finds no agent.
4. When the workflow returns a JSON/Markdown report pair, open exactly one `hosted-agent-validation-report` canvas with the returned JSON path:

   ```json
   {
     "report": "<absolute or workspace-relative JSON report path>"
   }
   ```

5. Derive a stable instance ID from the report path. Use only alphanumeric characters, `.`, `_`, or `-`; start with an alphanumeric character; and limit it to 128 characters.
6. Do not open a canvas without a report pair.