{"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, syncing with API gateways, customizing the portal, or managing API inventory, and oth","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-L38 | Best practices for API governance in API Center: using managed linting for style compliance and applying shift-left checks via the VS Code extension. |\n| Security | L39-L44 | 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 | L45-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-L61 | 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 | L62-L66 | 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| Use managed linting to enforce API style compliance in Azure API Center | https://learn.microsoft.com/en-us/azure/api-center/enable-managed-api-analysis-linting |\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| 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| 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\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 |","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.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 549 github stars · SKILL.md body (4,598 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-05-18T18:53:48.249Z","embedding":null,"createdAt":"2026-04-18T21:58:07.771Z","updatedAt":"2026-05-18T18:53:48.249Z","lastSeenAt":"2026-05-18T18:53:48.249Z","tsv":"'/en-us/azure/api-center/authorize-api-access':399 '/en-us/azure/api-center/enable-api-analysis-linting':531 '/en-us/azure/api-center/enable-api-center-portal-vs-code-extension':411 '/en-us/azure/api-center/enable-managed-api-analysis-linting':372 '/en-us/azure/api-center/govern-apis-vscode-extension':385 '/en-us/azure/api-center/import-api-management-apis':494 '/en-us/azure/api-center/manage-apis-azure-cli':505 '/en-us/azure/api-center/metadata':425 '/en-us/azure/api-center/register-apis-github-actions':543 '/en-us/azure/api-center/register-manage-agents':437 '/en-us/azure/api-center/set-up-api-center-arm-template':447 '/en-us/azure/api-center/set-up-api-center-azure-cli':457 '/en-us/azure/api-center/set-up-api-center-bicep':467 '/en-us/azure/api-center/set-up-notification-workflow':517 '/en-us/azure/api-center/tutorials/add-metadata-properties':478 '/microsoftdocs/mcp/blob/main/readme.md)':162 '3':133 'a2a':429 'accept':201 'access':167,257,404 'action':342,540 'agent':82,126,185,199,287,430 'amazon':312 'api':3,9,25,29,36,41,51,218,221,245,249,251,259,275,282,303,305,310,313,331,337,351,363,368,377,390,395,401,420,433,440,450,460,474,486,488,490,496,507,522,527,533,536 'app':512 'appli':230,373 'apps/teams':325 'arm':443 'arm/bicep/cli':279 'author':246,391 'autom':24,319,330,506,521,532 'avail':152 'azur':2,8,40,50,274,321,336,350,367,394,419,432,439,449,453,459,473,485,501,526 'azure-api-cent':1 'best':13,54,210,215,354 'bicep':463 'capabl':74 'categori':85,93,109,205,207 'center':4,10,42,52,222,252,260,276,306,338,352,369,396,402,421,434,441,451,461,475,491,497,528,537 'check':234 'cli':322,454,502 'code':18,59,238,265,293,381,407,480 'combin':64 'complianc':228,365 'configur':16,57,244,267,271,389,412,415,426 'content':69,171 'control':400 'copilot':316 'cover':53 'creat':438 'custom':31,281,469 'defin':468 'deploy':21,62,273,326,458,518,524 'descript':209 'develop':11 'doc':177 'document':72,170 'e.g':97,113,339 'enforc':362 'expert':5,47 'extens':239,266,382,408 'fallback':189 'fetch':73,169,178,191 'file':103,111,118,123 'gateway':30,314 'github':341,539 'github.com':161 'github.com/microsoftdocs/mcp/blob/main/readme.md)':160 'govern':219,378,422 'guid':159 'guidanc':48 'host':348 'import':80,124,484 'includ':12 'index':86,206 'instal':156,158 'instruct':344 'integr':17,58,292,479 'inventori':37,290,498 'knowledg':6 'l120':100 'l33':213 'l33-l38':212 'l35':99 'l35-l120':98 'l38':214 'l39':242 'l39-l44':241 'l44':243 'l45':269 'l45-l54':268 'l54':270 'l55':296 'l55-l61':295 'l61':297 'l62':328 'l62-l66':327 'l66':329 'latest':141 'learn':184,198 'learn-agent-skil':183,197 'learn.microsoft.com':371,384,398,410,424,436,446,456,466,477,493,504,516,530,542 'learn.microsoft.com/en-us/azure/api-center/authorize-api-access':397 'learn.microsoft.com/en-us/azure/api-center/enable-api-analysis-linting':529 'learn.microsoft.com/en-us/azure/api-center/enable-api-center-portal-vs-code-extension':409 'learn.microsoft.com/en-us/azure/api-center/enable-managed-api-analysis-linting':370 'learn.microsoft.com/en-us/azure/api-center/govern-apis-vscode-extension':383 'learn.microsoft.com/en-us/azure/api-center/import-api-management-apis':492 'learn.microsoft.com/en-us/azure/api-center/manage-apis-azure-cli':503 'learn.microsoft.com/en-us/azure/api-center/metadata':423 'learn.microsoft.com/en-us/azure/api-center/register-apis-github-actions':541 'learn.microsoft.com/en-us/azure/api-center/register-manage-agents':435 'learn.microsoft.com/en-us/azure/api-center/set-up-api-center-arm-template':445 'learn.microsoft.com/en-us/azure/api-center/set-up-api-center-azure-cli':455 'learn.microsoft.com/en-us/azure/api-center/set-up-api-center-bicep':465 'learn.microsoft.com/en-us/azure/api-center/set-up-notification-workflow':515 'learn.microsoft.com/en-us/azure/api-center/tutorials/add-metadata-properties':476 'left':233,376 'like':309 'line':95,107,208 'link':112,121 'lint':225,332,360,523 'linting/analysis':283 'linting/registration':26 'local':65 'locat':89 'logic':324,511 'manag':35,224,254,291,311,359,428,487,499 'markdown':188,204 'mcp':147,174 'mcp/a2a':286 'metadata':284,416,470 'metadata.generated':128 'microsoft':176 'microsoftdoc':148,175 'month':134 'network':166 'notif':509 'old':135 'oth':39 'pattern':19,60,294,298,481 'platform':308 'plus':318 'portal':33,261,280,353,403 'practic':14,55,211,216,355 'prefer':172 'provid':46 'provis':448 'pull':139 'queri':180,194 'quick':67 'quick-refer':66 'rang':96 'read':102,117 'refer':68,122 'registr':334,508,534 'relev':90 'remot':71 'repositori':145 'requir':165 'return':187,203 'schema':285,417,471 'scheme':247,392 'script':300,495 'section':91 'secur':15,56,240,386 'security.md':114,115 'self':347 'self-host':346 'setup':277,288 'shift':232,375 'shift-left':231,374 'skill':43,45,79,164,186,200 'skill-azure-api-center' 'source-microsoftdocs' 'specifi':106 'string':181,195 'studio':317 'style':227,364 'suggest':136,153 'sync':27,302 'team':514 'templat':444,464 'text/markdown':202 'tool':149 'topic':356,387,413,482,519 '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':357,388,414,483,520 'use':22,77,83,101,116,173,190,223,358,452 'user':138,155 'version':142 'via':235,262,278,320,340,405,442 'vs':237,264,380,406 '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-05-18T18:53:48.249Z"}],"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":549,"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-05-17T02:50:05Z","description":"Curated Agent Skills for Microsoft & Azure – giving AI coding assistants structured, real-time expertise from Microsoft Learn docs.","skill_md_sha":"31309204dada07e4483eee904b1fd86b8ed8f259","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, syncing with API gateways, customizing the portal, or managing API inventory, and other Azure Api Center related development tasks. Not for Azure API Management (use azure-api-management), Azure App Service (use azure-app-service), Azure Functions (use azure-functions).","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-05-18T18:53:48.249Z"}}