Microsoftdocs Agent Skills

Included skill

Azure Api Center

Expert knowledge for Azure Api Center development including best practices, security, configuration, integrations & coding patterns, and deployment. Use when automating API linting/registration, portal self-hosting, governance schemas, backups, or cross-platform sync, and other Azure Api Center related development tasks. Not for Azure API Management (use azure-api-management), Azure Resource Manager (use azure-resource-manager), Azure Portal (use azure-portal).

Source: /skills/azure-api-center/SKILL.md

Azure Api Center Skill

This 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.

How to Use This Skill

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

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

This skill requires network access to fetch documentation content:

  • Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
  • Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category Lines Description
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.
Security L39-L44 Configuring API auth schemes (keys, OAuth, etc.) in API Center and managing portal access/permissions via the VS Code extension
Configuration L45-L54 Configuring API Center instances: deployment via ARM/Bicep/CLI, setting up backup/restore, and defining/customizing governance metadata schemas.
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
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.

Best Practices

Topic URL
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
Apply shift-left API governance with VS Code extension https://learn.microsoft.com/en-us/azure/api-center/govern-apis-vscode-extension

Security

Topic URL
Configure API authorization schemes in Azure API Center https://learn.microsoft.com/en-us/azure/api-center/authorize-api-access
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

Configuration

Topic URL
Configure backup and restore for Azure API Center https://learn.microsoft.com/en-us/azure/api-center/backup-restore
Configure metadata schema for Azure API Center governance https://learn.microsoft.com/en-us/azure/api-center/metadata
Create Azure API Center via ARM template https://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-arm-template
Provision Azure API Center using Azure CLI https://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-azure-cli
Deploy Azure API Center with Bicep templates https://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-bicep
Define custom metadata schema in Azure API Center https://learn.microsoft.com/en-us/azure/api-center/tutorials/add-metadata-properties

Integrations & Coding Patterns

Topic URL
Import Azure API Management APIs into API Center https://learn.microsoft.com/en-us/azure/api-center/import-api-management-apis
Script API Center inventory management with Azure CLI https://learn.microsoft.com/en-us/azure/api-center/manage-apis-azure-cli
Automate API registration notifications with Logic Apps and Teams https://learn.microsoft.com/en-us/azure/api-center/set-up-notification-workflow

Deployment

Topic URL
Automate API linting deployment in Azure API Center https://learn.microsoft.com/en-us/azure/api-center/enable-api-analysis-linting
Automate API registration to API Center with GitHub Actions https://learn.microsoft.com/en-us/azure/api-center/register-apis-github-actions