Agent skill · software engineering · github
foundry-agent-sync
Create and synchronize prompt-based AI agents directly within Azure AI Foundry via REST API, from a local JSON manifest. Unlike scaffolding skills that only generate local code, this skill registers agents in the Foundry service itself — making them immediately available for invocation. Use when the user asks to create agents in Foundry, sync, deploy, register, or push agents to Foundry, update agent instructions, or scaffold the manifest and sync script for a new repository. Triggers: 'create agent in foundry', 'sync foundry agents', 'deploy agents to foundry', 'register agents in foundry', 'push agents', 'create foundry agent manifest', 'scaffold agent sync'.
Why this skill is useful
Adds a PowerShell script for synchronizing agents with Azure AI Foundry, which provides capabilities not available in public documentation.
What it needs
Requires azure-cli installed locally. Requires azure account access. About 4k tokens when loaded. Last updated 2026-08-07. 37,534 stars on the source repository.
What this skill does
Foundry Agent Sync Overview Create and synchronize prompt-based AI agents directly within Azure AI Foundry via the Agent Service REST API. This skill registers agents in the Foundry service itself — making them immediately available for invocation, evaluation, and management through the Foundry portal or API. Each agent is created or updated idempotently via a named POST call, using definitions from a local JSON manifest file. Key distinction: This skill creates agents inside AI Foundry (server-side). It does not scaffold local agent code or container images — for that, use the microsoft-foundry skill's create sub-skill. Prerequisites The user must have: 1. An Azure AI Foundry project with a deployed model (e.g. gpt-5-4) 2. Azure CLI (az) authenticated with access to the Foundry project 3. The Azure AI User role (or higher) on the Foundry project resource Collect these values before proceeding: Value How to get it --- --- Foundry project endpoint Azure Portal → AI Foundry project → Overview → Endpoint, or az resource show Subscription ID az account show --query id -o tsv Model deployment name The model name deployed in the Foundry project (e.g. gpt-5-4) Manifest Format The manifest is a JSON array where each entry defines one agent. Look for it at common paths: infra/foundry-agents.json, foundry-agents.json, or .foundry/agents.json. If none exists, scaffold one. Field Reference Field Required Description --- --- --- useCaseId Yes Kebab-case identifier; used to build the agent name ({prefix}-{useCaseId}) description Yes Human-readable description stored as agent metadata baseInstruction Yes System prompt / base instructions for the agent Sync Script PowerShell (interactive / CI) Create or locate the sync script. The canonical path is infra/scripts/sync-foundry-agents.ps1 but adapt to the repo layout. Bash (Bicep deployment script / CI) For automated deployment via Microsoft.Resources/deploymentScripts, use a bash script that: 1. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills github/foundry-agent-sync