{"id":"fe1eec31-aeee-41ee-bbe2-1a3192904720","shortId":"K2prg5","kind":"skill","title":"azure-api-center","tagline":"Expert knowledge for Azure Api Center development including best practices, security, configuration, integrations & coding patterns, and deployment. Use when automating API linting/registration, customizing the portal, syncing with API gateways, or enforcing design-time governanc","description":"# Azure Api Center Skill\n\nThis skill provides expert guidance for Azure Api Center. Covers best practices, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.\n\n## How to Use This Skill\n\n> **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file\n\n> **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)\n\nThis skill requires **network access** to fetch documentation content:\n- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.\n- **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.\n\n## Category Index\n\n| Category | Lines | Description |\n|----------|-------|-------------|\n| Best Practices | L33-L37 | Best practices for enforcing API governance early in development using the Azure API Center VS Code extension, including policy checks, linting, and design-time validation. |\n| Security | L38-L43 | Configuring API authorization schemes for APIs in API Center and managing who can access the API Center portal via the VS Code extension |\n| Configuration | L44-L54 | Configuring and deploying Azure API Center: setup via ARM/Bicep/CLI, portal customization, API linting/analysis, metadata schemas, MCP/A2A agent setup, and inventory management. |\n| Integrations & Coding Patterns | L55-L64 | Patterns and scripts for syncing APIs between API Center and platforms like API Management, Amazon API Gateway, and Copilot Studio, plus automation via Azure CLI and Logic Apps/Teams |\n| Deployment | L65-L70 | Automating API linting and registration to Azure API Center (e.g., via GitHub Actions) and instructions for self-hosting the Azure API Center portal. |\n\n### Best Practices\n| Topic | URL |\n|-------|-----|\n| Apply shift-left API governance with VS Code extension | https://learn.microsoft.com/en-us/azure/api-center/govern-apis-vscode-extension |\n\n### Security\n| Topic | URL |\n|-------|-----|\n| Configure API authorization schemes in Azure API Center | https://learn.microsoft.com/en-us/azure/api-center/authorize-api-access |\n| Control API Center portal access via VS Code extension | https://learn.microsoft.com/en-us/azure/api-center/enable-api-center-portal-vs-code-extension |\n\n### Configuration\n| Topic | URL |\n|-------|-----|\n| Use managed API linting and analysis in Azure API Center | https://learn.microsoft.com/en-us/azure/api-center/enable-managed-api-analysis-linting |\n| Configure metadata schema for Azure API Center governance | https://learn.microsoft.com/en-us/azure/api-center/metadata |\n| Configure and manage A2A agents in Azure API Center | https://learn.microsoft.com/en-us/azure/api-center/register-manage-agents |\n| Create Azure API Center via ARM template | https://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-arm-template |\n| Provision Azure API Center using Azure CLI | https://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-azure-cli |\n| Deploy Azure API Center with Bicep templates | https://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-bicep |\n| Define custom metadata schema in Azure API Center | https://learn.microsoft.com/en-us/azure/api-center/tutorials/add-metadata-properties |\n\n### Integrations & Coding Patterns\n| Topic | URL |\n|-------|-----|\n| Export API Center APIs as Copilot Studio connectors | https://learn.microsoft.com/en-us/azure/api-center/export-to-copilot-studio |\n| Import Azure API Management APIs into API Center | https://learn.microsoft.com/en-us/azure/api-center/import-api-management-apis |\n| Script API Center inventory management with Azure CLI | https://learn.microsoft.com/en-us/azure/api-center/manage-apis-azure-cli |\n| Automate API registration notifications with Logic Apps and Teams | https://learn.microsoft.com/en-us/azure/api-center/set-up-notification-workflow |\n| Synchronize Azure API Management APIs with API Center | https://learn.microsoft.com/en-us/azure/api-center/synchronize-api-management-apis |\n| Sync Amazon API Gateway APIs into Azure API Center | https://learn.microsoft.com/en-us/azure/api-center/synchronize-aws-gateway-apis |\n\n### Deployment\n| Topic | URL |\n|-------|-----|\n| Automate API linting deployment in Azure API Center | https://learn.microsoft.com/en-us/azure/api-center/enable-api-analysis-linting |\n| Automate API registration to API Center with GitHub Actions | https://learn.microsoft.com/en-us/azure/api-center/register-apis-github-actions |\n| Self-host the Azure API Center portal implementation | https://learn.microsoft.com/en-us/azure/api-center/self-host-api-center-portal |","tags":["azure","api","center","agent","skills","microsoftdocs","agent-skills","agentic-skills","agentskill","ai-agents","ai-coding","azure-functions"],"capabilities":["skill","source-microsoftdocs","skill-azure-api-center","topic-agent","topic-agent-skills","topic-agentic-skills","topic-agentskill","topic-ai-agents","topic-ai-coding","topic-azure","topic-azure-functions","topic-azure-kubernetes-service","topic-azure-openai","topic-azure-sql-database","topic-azure-storage"],"categories":["Agent-Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/MicrosoftDocs/Agent-Skills/azure-api-center","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add MicrosoftDocs/Agent-Skills","source_repo":"https://github.com/MicrosoftDocs/Agent-Skills","install_from":"skills.sh"}},"qualityScore":"0.698","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 497 github stars · SKILL.md body (5,158 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T12:53:29.339Z","embedding":null,"createdAt":"2026-04-18T21:58:07.771Z","updatedAt":"2026-04-22T12:53:29.339Z","lastSeenAt":"2026-04-22T12:53:29.339Z","tsv":"'/en-us/azure/api-center/authorize-api-access':385 '/en-us/azure/api-center/enable-api-analysis-linting':564 '/en-us/azure/api-center/enable-api-center-portal-vs-code-extension':397 '/en-us/azure/api-center/enable-managed-api-analysis-linting':413 '/en-us/azure/api-center/export-to-copilot-studio':493 '/en-us/azure/api-center/govern-apis-vscode-extension':371 '/en-us/azure/api-center/import-api-management-apis':504 '/en-us/azure/api-center/manage-apis-azure-cli':515 '/en-us/azure/api-center/metadata':424 '/en-us/azure/api-center/register-apis-github-actions':576 '/en-us/azure/api-center/register-manage-agents':436 '/en-us/azure/api-center/self-host-api-center-portal':588 '/en-us/azure/api-center/set-up-api-center-arm-template':446 '/en-us/azure/api-center/set-up-api-center-azure-cli':456 '/en-us/azure/api-center/set-up-api-center-bicep':466 '/en-us/azure/api-center/set-up-notification-workflow':527 '/en-us/azure/api-center/synchronize-api-management-apis':538 '/en-us/azure/api-center/synchronize-aws-gateway-apis':550 '/en-us/azure/api-center/tutorials/add-metadata-properties':477 '/microsoftdocs/mcp/blob/main/readme.md)':162 '3':133 'a2a':428 'accept':201 'access':167,258,390 'action':343,573 'agent':82,126,185,199,288,429 'amazon':313,540 'analysi':406 'api':3,9,25,32,41,51,219,227,246,250,252,260,276,283,304,306,311,314,332,338,352,363,376,381,387,403,409,419,432,439,449,459,473,484,486,496,498,500,506,517,530,532,534,541,543,546,555,560,566,569,582 'app':522 'appli':359 'apps/teams':326 'arm':442 'arm/bicep/cli':280 'author':247,377 'autom':24,320,331,516,554,565 'avail':152 'azur':2,8,40,50,226,275,322,337,351,380,408,418,431,438,448,452,458,472,495,511,529,545,559,581 'azure-api-cent':1 'best':13,54,210,215,355 'bicep':462 'capabl':74 'categori':85,93,109,205,207 'center':4,10,42,52,228,253,261,277,307,339,353,382,388,410,420,433,440,450,460,474,485,501,507,535,547,561,570,583 'check':234 'cli':323,453,512 'code':18,59,230,266,294,367,393,479 'combin':64 'configur':16,57,245,268,272,375,398,414,425 'connector':490 'content':69,171 'control':386 'copilot':317,488 'cover':53 'creat':437 'custom':27,282,468 'defin':467 'deploy':21,62,274,327,457,551,557 'descript':209 'design':37,238 'design-tim':36,237 'develop':11,223 'doc':177 'document':72,170 'e.g':97,113,340 'earli':221 'enforc':35,218 'expert':5,47 'export':483 'extens':231,267,368,394 'fallback':189 'fetch':73,169,178,191 'file':103,111,118,123 'gateway':33,315,542 'github':342,572 'github.com':161 'github.com/microsoftdocs/mcp/blob/main/readme.md)':160 'govern':220,364,421 'governanc':39 'guid':159 'guidanc':48 'host':349,579 'implement':585 'import':80,124,494 'includ':12,232 'index':86,206 'instal':156,158 'instruct':345 'integr':17,58,293,478 'inventori':291,508 'knowledg':6 'l120':100 'l33':213 'l33-l37':212 'l35':99 'l35-l120':98 'l37':214 'l38':243 'l38-l43':242 'l43':244 'l44':270 'l44-l54':269 'l54':271 'l55':297 'l55-l64':296 'l64':298 'l65':329 'l65-l70':328 'l70':330 'latest':141 'learn':184,198 'learn-agent-skil':183,197 'learn.microsoft.com':370,384,396,412,423,435,445,455,465,476,492,503,514,526,537,549,563,575,587 'learn.microsoft.com/en-us/azure/api-center/authorize-api-access':383 'learn.microsoft.com/en-us/azure/api-center/enable-api-analysis-linting':562 'learn.microsoft.com/en-us/azure/api-center/enable-api-center-portal-vs-code-extension':395 'learn.microsoft.com/en-us/azure/api-center/enable-managed-api-analysis-linting':411 'learn.microsoft.com/en-us/azure/api-center/export-to-copilot-studio':491 'learn.microsoft.com/en-us/azure/api-center/govern-apis-vscode-extension':369 'learn.microsoft.com/en-us/azure/api-center/import-api-management-apis':502 'learn.microsoft.com/en-us/azure/api-center/manage-apis-azure-cli':513 'learn.microsoft.com/en-us/azure/api-center/metadata':422 'learn.microsoft.com/en-us/azure/api-center/register-apis-github-actions':574 'learn.microsoft.com/en-us/azure/api-center/register-manage-agents':434 'learn.microsoft.com/en-us/azure/api-center/self-host-api-center-portal':586 'learn.microsoft.com/en-us/azure/api-center/set-up-api-center-arm-template':444 'learn.microsoft.com/en-us/azure/api-center/set-up-api-center-azure-cli':454 'learn.microsoft.com/en-us/azure/api-center/set-up-api-center-bicep':464 'learn.microsoft.com/en-us/azure/api-center/set-up-notification-workflow':525 'learn.microsoft.com/en-us/azure/api-center/synchronize-api-management-apis':536 'learn.microsoft.com/en-us/azure/api-center/synchronize-aws-gateway-apis':548 'learn.microsoft.com/en-us/azure/api-center/tutorials/add-metadata-properties':475 'left':362 'like':310 'line':95,107,208 'link':112,121 'lint':235,333,404,556 'linting/analysis':284 'linting/registration':26 'local':65 'locat':89 'logic':325,521 'manag':255,292,312,402,427,497,509,531 'markdown':188,204 'mcp':147,174 'mcp/a2a':287 'metadata':285,415,469 'metadata.generated':128 'microsoft':176 'microsoftdoc':148,175 'month':134 'network':166 'notif':519 'old':135 'pattern':19,60,295,299,480 'platform':309 'plus':319 'polici':233 'portal':29,262,281,354,389,584 'practic':14,55,211,216,356 'prefer':172 'provid':46 'provis':447 'pull':139 'queri':180,194 'quick':67 'quick-refer':66 'rang':96 'read':102,117 'refer':68,122 'registr':335,518,567 'relev':90 'remot':71 'repositori':145 'requir':165 'return':187,203 'schema':286,416,470 'scheme':248,378 'script':301,505 'section':91 'secur':15,56,241,372 'security.md':114,115 'self':348,578 'self-host':347,577 'setup':278,289 'shift':361 'shift-left':360 'skill':43,45,79,164,186,200 'skill-azure-api-center' 'source-microsoftdocs' 'specifi':106 'string':181,195 'studio':318,489 'suggest':136,153 'sync':30,303,539 'synchron':528 'team':524 'templat':443,463 'text/markdown':202 'time':38,239 'tool':149 'topic':357,373,399,481,552 'topic-agent' 'topic-agent-skills' 'topic-agentic-skills' 'topic-agentskill' 'topic-ai-agents' 'topic-ai-coding' 'topic-azure' 'topic-azure-functions' 'topic-azure-kubernetes-service' 'topic-azure-openai' 'topic-azure-sql-database' 'topic-azure-storage' 'url':358,374,400,482,553 'use':22,77,83,101,116,173,190,224,401,451 'user':138,155 'valid':240 'version':142 'via':263,279,321,341,391,441 'vs':229,265,366,392 'webpag':192","prices":[{"id":"206f23fe-2d87-43e1-bd40-5d00b2d3cc75","listingId":"fe1eec31-aeee-41ee-bbe2-1a3192904720","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"MicrosoftDocs","category":"Agent-Skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:58:07.771Z"}],"sources":[{"listingId":"fe1eec31-aeee-41ee-bbe2-1a3192904720","source":"github","sourceId":"MicrosoftDocs/Agent-Skills/azure-api-center","sourceUrl":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-api-center","isPrimary":false,"firstSeenAt":"2026-04-18T21:58:07.771Z","lastSeenAt":"2026-04-22T12:53:29.339Z"}],"details":{"listingId":"fe1eec31-aeee-41ee-bbe2-1a3192904720","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"MicrosoftDocs","slug":"azure-api-center","github":{"repo":"MicrosoftDocs/Agent-Skills","stars":497,"topics":["agent","agent-skills","agentic-skills","agentskill","ai","ai-agents","ai-coding","azure","azure-functions","azure-kubernetes-service","azure-openai","azure-sql-database","azure-storage","azure-virtual-machine","claude-code","github-copilot","microsoft-learn","openai-codex","skills"],"license":"cc-by-4.0","html_url":"https://github.com/MicrosoftDocs/Agent-Skills","pushed_at":"2026-04-22T01:37:27Z","description":"Curated Agent Skills for Microsoft & Azure – giving AI coding assistants structured, real-time expertise from Microsoft Learn docs.","skill_md_sha":"5ca69a90daaa11cc5571429a32e36c83ec057895","skill_md_path":"skills/azure-api-center/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-api-center"},"layout":"multi","source":"github","category":"Agent-Skills","frontmatter":{"name":"azure-api-center","description":"Expert knowledge for Azure Api Center development including best practices, security, configuration, integrations & coding patterns, and deployment. Use when automating API linting/registration, customizing the portal, syncing with API gateways, or enforcing design-time governance, and other Azure Api Center related development tasks. Not for Azure API Management (use azure-api-management), Azure App Configuration (use azure-app-configuration), Azure Service Connector (use azure-service-connector).","compatibility":"Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation."},"skills_sh_url":"https://skills.sh/MicrosoftDocs/Agent-Skills/azure-api-center"},"updatedAt":"2026-04-22T12:53:29.339Z"}}