Add foundry-agent-sync skill

[onsenturk]

New Skill: foundry-agent-sync

Create and synchronize prompt-based AI agents directly within Azure AI Foundry via the Agent Service REST API, from a local JSON manifest.

What it does

Unlike scaffolding skills that only generate local code, this skill registers agents in the Foundry service itself — making them immediately available for invocation, evaluation, and management through the Foundry portal or API.

Key features

• JSON manifest — Define agents as a simple JSON array with useCaseId, description, and baseInstruction fields
• Idempotent sync — Creates or updates agents via named POST calls; safe to run repeatedly
• PowerShell & Bash scripts — Ready-to-use sync scripts for interactive use or CI pipelines
• Bicep integration — Optional deployment script integration for infrastructure-as-code workflows
• REST API reference — Complete API surface documented for create, list, get, and delete operations

Trigger phrases

• "create agent in foundry"
• "sync foundry agents"
• "deploy agents to foundry"
• "register agents in foundry"
• "push agents"
• "create foundry agent manifest"
• "scaffold agent sync"

Checklist

• name field matches folder name (foundry-agent-sync)
• description explains WHAT and WHEN with trigger keywords
• Body content is under 500 lines
• Follows the Agent Skills specification
• Branch created from latest staged
• npm start run to update docs/README.skills.md

[github-actions]

🔍 Skill Validator Results

✅ All checks passed

Scope	Checked
Skills	1
Agents	1
Total	2
Severity	Count
---	---:
❌ Errors	0
⚠️ Warnings	0
ℹ️ Advisories	0

Summary

Level	Finding
ℹ️	Found 1 skill(s)
ℹ️	[foundry-agent-sync] 📊 foundry-agent-sync: 2,082 BPE tokens [chars/4: 2,100] (detailed ✓), 19 sections, 6 code blocks
ℹ️	✅ All checks passed (1 skill(s))

Full validator output

```text Found 1 skill(s) [foundry-agent-sync] 📊 foundry-agent-sync: 2,082 BPE tokens [chars/4: 2,100] (detailed ✓), 19 sections, 6 code blocks ✅ All checks passed (1 skill(s)) ```

[Copilot]

Pull request overview

Adds a new Agent Skill (foundry-agent-sync) that guides users to create/update Azure AI Foundry prompt-based agents from a local JSON manifest via the Foundry Agent Service REST API.

Changes:

• Added skills/foundry-agent-sync/SKILL.md with manifest format, sync workflow, and REST API reference.
• Updated docs/README.skills.md to include the new skill in the skills index.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
skills/foundry-agent-sync/SKILL.md	Introduces the new skill content, including example sync scripts and API reference.
docs/README.skills.md	Registers the new skill in the generated skills table for discovery.

[Copilot]

The PowerShell snippet uses the null-coalescing operator (??) when computing $version, which only works in PowerShell 7+. If this script is intended to be copy/paste friendly for Windows PowerShell 5.1 as well, either rewrite this fallback logic in a PS 5.1-compatible way or explicitly call out a PowerShell 7+ requirement in the prerequisites for the sync script.

Suggested change

	$version = $resp.version ?? $resp.latest_version ?? $resp.id ?? 'unknown'
	$version = 'unknown'
	if ($resp.version) {
	$version = $resp.version
	} elseif ($resp.latest_version) {
	$version = $resp.latest_version
	} elseif ($resp.id) {
	$version = $resp.id
	}