About azure-app-configuration
azure-app-configuration is an Agent skill covering troubleshooting, configuration, security, integrations, and deployment for Azure App Configuration. It combines local quick references with remote documentation retrieval for developers managing configuration stores and integrating them into applications.
Key features
- 01Troubleshooting and usage practices
- 02Feature flag and configuration guidance
- 03Identity, access, and network security references
- 04Application integration, coding patterns, and deployment
Use cases
- 01Diagnose feature flag telemetry and network access issues
- 02Configure feature flags, snapshots, and dynamic refresh
- 03Integrate App Configuration into applications and CI/CD
MCP support
The skill prefers mcp_microsoftdocs microsoft_docs_fetch to retrieve remote documentation, with fetch_webpage as a fallback.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-app-configurationAfter installing, type/azure-app-configurationin Claude Code to confirm it loaded.
Details
From the project READMEAzure App Configuration Skill
This skill provides expert guidance for Azure App Configuration. Covers troubleshooting, best practices, decision making, limits & quotas, 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 |
|---|---|---|
| Troubleshooting | L36-L41 | Troubleshooting feature flag issues with Application Insights telemetry and diagnosing Azure App Configuration network access and connectivity errors. |
| Best Practices | L42-L49 | Best practices for App Configuration disaster recovery, efficient usage, and advanced feature management using conditional and targeting filters for safe, controlled rollouts. |
| Decision Making | L50-L56 | Guidance on App Configuration client library lifecycle, upgrading Spring Boot apps to v6, and using scorecards to evaluate feature flag impact and decision outcomes. |
| Limits & Quotas | L57-L65 | Limits, quotas, retention, and lifecycle rules for App Configuration: snapshots, soft delete, feature flag/key-value revisions, throttling, and preview API behavior. |
| Security | L66-L89 | Configuring encryption, identity, and access for App Configuration: keys, Entra ID/RBAC, managed identities, private endpoints, network perimeters, HMAC/REST auth, and security best practices/policies. |
| Configuration | L90-L105 | Configuring App Configuration behavior: feature flags, snapshots, geo-replication, soft delete, Kubernetes provider, Spring refresh, Front Door, and AI/chat completion settings. |
| Integrations & Coding Patterns | L106-L184 | Patterns and code samples for integrating Azure App Configuration into apps (.NET, Go, JS, Python, Functions, AKS), using dynamic config, feature flags, filters, and REST/Key Vault APIs. |
| Deployment | L185-L192 | Using App Configuration in CI/CD: exporting/importing settings, creating snapshots, integrating with Azure Pipelines, Helm/Kubernetes, and syncing configs via GitHub Actions. |
Troubleshooting
| Topic | URL |
|---|---|
| Review feature flag telemetry in Application Insights | https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-telemetry-review-results |
| Diagnose Azure App Configuration network access errors | https://learn.microsoft.com/en-us/azure/azure-app-configuration/network-access-errors |
Best Practices
| Topic | URL |
|---|---|
| Implement resilient disaster recovery for App Configuration | https://learn.microsoft.com/en-us/azure/azure-app-configuration/concept-disaster-recovery |
| Apply Azure App Configuration usage best practices | https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-best-practices |
| Use conditional feature filters in Azure App Configuration | https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-feature-filters |
| Implement targeting filters for feature rollouts | https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-targetingfilter |
Decision Making
| Topic | URL |
|---|---|
| Understand support lifecycle for App Configuration client libraries | https://learn.microsoft.com/en-us/azure/azure-app-configuration/client-library-support-policy |
| Upgrade Spring Boot apps to App Configuration library v6 | https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-convert-to-the-new-spring-boot |
| Use scorecards to assess feature flag impact | https://learn.microsoft.com/en-us/azure/azure-app-configuration/howto-metric-scorecards |
Limits & Quotas
| Topic | URL |
|---|---|
| Use point-in-time snapshots in Azure App Configuration | https://learn.microsoft.com/en-us/azure/azure-app-configuration/concept-point-time-snapshot |
| Understand preview API lifecycle and deprecation timelines for App Configuration | https://learn.microsoft.com/en-us/azure/azure-app-configuration/concept-preview-api-life-cycle |
| Enhanced feature flag revision retention limits | https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-enhanced-feature-flag-revisions |
| Key-value revision retention limits in App Configuration | https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-revisions |
| Throttling limits and quotas for App Configuration REST | https://learn.microsoft.com/en-us/azure/azure-app-configuration/rest-api-throttling |
Security
Configuration
Integrations & Coding Patterns
Deployment
| Topic | URL |
|---|---|
| Export App Configuration settings using Azure Pipelines | https://learn.microsoft.com/en-us/azure/azure-app-configuration/azure-pipeline-export-task |
| Import configuration into App Configuration using Azure Pipelines | https://learn.microsoft.com/en-us/azure/azure-app-configuration/azure-pipeline-import-task |
| Create App Configuration snapshots with Azure Pipelines | https://learn.microsoft.com/en-us/azure/azure-app-configuration/azure-pipeline-snapshot-task |
| Integrate App Configuration into CI/CD pipelines | https://learn.microsoft.com/en-us/azure/azure-app-configuration/integrate-ci-cd-pipeline |
| Sync GitHub configuration files to App Configuration via GitHub Actions | https://learn.microsoft.com/en-us/azure/azure-app-configuration/push-kv-github-action |