azure-api-center
Azure API Centerの開発において、ベストプラクティスやセキュリティ、構成、統合、デプロイに関する専門知識を提供するSkill。
📜 元の英語説明(参考)
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).
🇯🇵 日本人クリエイター向け解説
Azure API Centerの開発において、ベストプラクティスやセキュリティ、構成、統合、デプロイに関する専門知識を提供するSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-17
- 取得日時
- 2026-05-17
- 同梱ファイル
- 1
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
Azure Api Center スキル
このスキルは、Azure Api Center に関する専門的なガイダンスを提供します。ベストプラクティス、セキュリティ、構成、統合とコーディングパターン、デプロイメントを網羅しています。ローカルのクイックリファレンスコンテンツとリモートドキュメント取得機能を組み合わせています。
このスキルの使用方法
エージェントへの重要事項: 関連するセクションを見つけるには、以下のカテゴリインデックスを使用してください。行範囲が指定されているカテゴリ(例:
L35-L120)の場合は、指定された行でread_fileを使用してください。ファイルリンクが指定されているカテゴリ(例:[security.md](security.md))の場合は、リンクされた参照ファイルでread_fileを使用してください。
エージェントへの重要事項:
metadata.generated_atが3か月以上前の場合は、リポジトリから最新バージョンをプルするようにユーザーに提案してください。mcp_microsoftdocsツールが利用できない場合は、ユーザーにインストールを提案してください: インストールガイド
このスキルは、ドキュメントコンテンツを取得するためにネットワークアクセスを必要とします。
- 推奨: クエリ文字列
from=learn-agent-skillを指定してmcp_microsoftdocs:microsoft_docs_fetchを使用してください。Markdown を返します。 - フォールバック: クエリ文字列
from=learn-agent-skill&accept=text/markdownを指定してfetch_webpageを使用してください。Markdown を返します。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| ベストプラクティス | L33-L38 | API Center における API ガバナンスのベストプラクティス: スタイル準拠のためのマネージドリンティングの使用と、VS Code 拡張機能によるシフトレフトチェックの適用。 |
| セキュリティ | L39-L44 | API Center の API の API 認証スキームの構成と、VS Code 拡張機能による API Center ポータルへのアクセス管理。 |
| 構成 | L45-L54 | Azure API Center の構成とデプロイ: ARM/Bicep/CLI によるセットアップ、ポータルのカスタマイズ、API リンティング/分析、メタデータスキーマ、MCP/A2A エージェントのセットアップ、およびインベントリ管理。 |
| 統合とコーディングパターン | L55-L61 | API Center と API Management、Amazon API Gateway、Copilot Studio などのプラットフォーム間で API を同期するためのパターンとスクリプト、および Azure CLI と Logic Apps/Teams による自動化。 |
| デプロイメント | L62-L66 | Azure API Center への API リンティングと登録の自動化(例: GitHub Actions 経由)と、Azure API Center ポータルのセルフホスティングの手順。 |
ベストプラクティス
| トピック | URL |
|---|---|
| Azure API Center でマネージドリンティングを使用して API スタイルの準拠を強制する | https://learn.microsoft.com/en-us/azure/api-center/enable-managed-api-analysis-linting |
| VS Code 拡張機能でシフトレフト API ガバナンスを適用する | https://learn.microsoft.com/en-us/azure/api-center/govern-apis-vscode-extension |
セキュリティ
| トピック | URL |
|---|---|
| Azure API Center で API 認証スキームを構成する | https://learn.microsoft.com/en-us/azure/api-center/authorize-api-access |
| VS Code 拡張機能で API Center ポータルアクセスを制御する | https://learn.microsoft.com/en-us/azure/api-center/enable-api-center-portal-vs-code-extension |
構成
| トピック | URL |
|---|---|
| Azure API Center ガバナンスのメタデータスキーマを構成する | https://learn.microsoft.com/en-us/azure/api-center/metadata |
| Azure API Center で A2A エージェントを構成および管理する | https://learn.microsoft.com/en-us/azure/api-center/register-manage-agents |
| ARM テンプレートを使用して Azure API Center を作成する | https://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-arm-template |
| Azure CLI を使用して Azure API Center をプロビジョニングする | https://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-azure-cli |
| Bicep テンプレートを使用して Azure API Center をデプロイする | https://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-bicep |
| Azure API Center でカスタムメタデータスキーマを定義する | https://learn.microsoft.com/en-us/azure/api-center/tutorials/add-metadata-properties |
統合とコーディングパターン
| トピック | URL |
|---|---|
| Azure API Management API を API Center にインポートする | https://learn.microsoft.com/en-us/azure/api-center/import-api-management-apis |
| Azure CLI で API Center インベントリ管理をスクリプト化する | https://learn.microsoft.com/en-us/azure/api-center/manage-apis-azure-cli |
| Logic Apps と Teams で API 登録通知を自動化する | https://learn.microsoft.com/en-us/azure/api-center/set-up-notification-workflow |
デプロイメント
| トピック | URL |
|---|---|
| Azure API Center で API リンティングのデプロイを自動化する | https://learn.microsoft.com/en-us/azure/api-center/enable-api-analysis-linting |
| GitHub Actions で API Center への API 登録を自動化する | https://learn.microsoft.com/en-us/azure/api-center/register-apis-github-actions |
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
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), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools 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_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=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 authorization schemes for APIs in API Center and managing who can access the API Center portal via the VS Code extension |
| 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. |
| 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 metadata schema for Azure API Center governance | https://learn.microsoft.com/en-us/azure/api-center/metadata |
| Configure and manage A2A agents in Azure API Center | https://learn.microsoft.com/en-us/azure/api-center/register-manage-agents |
| 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 |