Agentic Resource Discovery (ARD)
Git-Ape publishes an ARD ai-catalog.json so that AI agents and tools that support Agentic Resource Discovery can automatically find and invoke Git-Ape skills.
What is ARD?​
Agentic Resource Discovery is an open protocol that lets AI agents discover skills and tools published by any team or organisation — similar to how DNS lets browsers discover websites. An AI agent can query an ARD catalog endpoint to find available skills, read their descriptions, and invoke them automatically.
Catalog Endpoint​
Git-Ape's catalog is published at:
https://azure.github.io/git-ape/.well-known/ai-catalog.json
The catalog lists all 15 Git-Ape skills.
Git-Ape's docs are a GitHub Pages project site, so the catalog is served under the /git-ape/ path prefix (as shown above) rather than at the azure.github.io domain root. Register the full URL above with your ARD-enabled agent or discovery service.
Git-Ape Skills in the Catalog​
| Skill | Description |
|---|---|
| Azure Cost Estimator | Estimate monthly costs by querying the Azure Retail Prices API against ARM templates |
| Azure Deployment Preflight | What-if analysis, permission checks, and resource change preview before any deployment |
| Azure Drift Detector | Detect and reconcile configuration drift between deployed Azure resources and stored state |
| Azure Integration Tester | Post-deployment health checks for Function Apps, Storage, Databases, and App Services |
| Azure Naming Research | Look up CAF abbreviations, naming rules, and regex patterns for Azure resource types |
| Azure Policy Advisor | Assess ARM templates for CIS/NIST/FedRAMP policy gaps and subscription-level assignments |
| Azure Resource Availability | Validate VM SKUs, Kubernetes versions, API versions, and quota before deploying |
| Azure Resource Visualizer | Generate Mermaid architecture diagrams from live Azure resource groups |
| Azure REST API Reference | Look up exact property schemas, required fields, and stable API versions for any resource type |
| Azure Role Selector | Recommend least-privilege RBAC roles for managed identities and service principals |
| Azure Security Analyzer | Per-resource security assessment with severity ratings before deployment confirmation |
| Azure Stack Deploy | Run a subscription-scoped Azure Deployment Stack and write state.json |
| Azure Stack Destroy | Tear down a Git-Ape deployment and purge soft-deleted resources |
| Git-Ape Onboarding | Bootstrap Entra OIDC, RBAC, GitHub environments, and CI/CD workflow scaffolding |
| Prerequisites Check | Validate az, gh, jq, git installation and auth sessions |
Catalog Format​
The catalog follows the ARD ai-catalog.json spec v1.0:
{
"specVersion": "1.0",
"host": { "displayName": "Azure Git-Ape", "identifier": "azure.github.io" },
"entries": [ ... ],
"collections": []
}
Each entries[] item includes identifier, displayName, type: "application/ai-skill", url (the skill's SKILL.md), and a description derived from the skill's SKILL.md frontmatter (condensed for length).
The collections[] array is ARD's federation mechanism — it links sub-catalogs by URL so a crawler can resolve them without inlining their entries. Git-Ape's catalog currently federates no external collections, so it ships as "collections": [].
Adding Git-Ape to an ARD-Enabled Agent​
If your AI agent or tool supports ARD discovery, register the catalog URL:
https://azure.github.io/git-ape/.well-known/ai-catalog.json
The agent will discover all 15 Git-Ape skills and their descriptions, and can invoke them via the GitHub Copilot skill invocation protocol.