Subchapter 53.33
foundry-agent/create/references/skills/managed-harness-agent-skill-attach.mdMarkdown1 KBView on GitHub
Manage Foundry Skills separately with azd ai skill; the Agent only consumes existing versioned Skills.
Obtain the immutable version:
azd ai skill show <skill-name> \
--project-endpoint "<project-endpoint>" \
--output jsonAttach it in the Agent service:
skills:
- name: issue-triage
version: "3"Do not silently select the default version when the user requested a specific version.
The local directory must contain SKILL.md at its root. Create the Foundry resource only when the user explicitly asks:
azd ai skill create issue-triage \
--file ./skills/issue-triage/ \
--project-endpoint "<project-endpoint>" \
--output jsonUse the returned version in the Agent’s skills list. Later edits create a new immutable version:
azd ai skill update issue-triage \
--file ./skills/issue-triage/ \
--project-endpoint "<project-endpoint>" \
--output jsonReplace the pinned version before redeploying the Agent.
Do not add a host: azure.ai.skill service during this phase; it would make azd deploy create or update the Skill. Do not route Skills through a Toolbox: the Copilot harness accepts top-level versioned Skill references.