Agent skill

Deploy Diagnostics

by EmeaAppGbb in EmeaAppGbb/spec2cloud

Diagnose and resolve Azure deployment failures by analyzing error output, checking Azure resource state, and suggesting fixes.

MITAuto-check passedTesting & QA

Install Deploy Diagnostics

skills CLI
$ npx skills add EmeaAppGbb/spec2cloud --skill deploy-diagnostics -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install EmeaAppGbb/spec2cloud deploy-diagnostics --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/EmeaAppGbb/spec2cloud.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/deploy-diagnostics .claude/skills/deploy-diagnostics && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
deploy-diagnostics
GitHub stars
100
Token cost
~511 tokens
SKILL.md length
126 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

Diagnose and resolve Azure deployment failures by analyzing error output, checking Azure resource state, and suggesting fixes.

  • Works in 5 steps: Parse error output — Identify the error… → Classify the error — Match against known… → Check resource state — Verify Azure… → …
  • Azd provision fails
  • SKILL.md covers Steps, Known Failure Patterns, Diagnostic Commands and Output Format
  • Calls az

What it does

Deploy Diagnostics is an agent skill from EmeaAppGbb/spec2cloud. Diagnose and resolve Azure deployment failures by analyzing error output, checking Azure resource state, and suggesting fixes. Use when azd provision fails, azd deploy fails, smoke tests fail against live deployment, container images fail to push/pull, or any Phase 6 deployment error occurs. Trigger on deployment errors, infrastructure failures, or post-deploy smoke test failures.

Its SKILL.md is about 510 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA, covering QA and bug reports, Deployment and Containers. It works with Microsoft Azure. The licence is MIT.

When your agent uses it

  • Azd provision fails
  • Azd deploy fails
  • Smoke tests fail against live deployment
  • Container images fail to push/pull

Example prompts

  • “/deploy-diagnostics”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Parse error output — Identify the error type from AZD stdout/stderr
  2. Classify the error — Match against known patterns (see below)
  3. Check resource state — Verify Azure resource health if accessible
  4. Suggest fix — Provide specific remediation
  5. Verify fix — After applying, re-run the failed command

What it can do on your machine

Read from SKILL.md and the folder at commit 8e76618. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • az

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use az, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Deploy Diagnostics loads about 511 tokens when it runs. Until then it costs about 101 tokens; SKILL.md has 126 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~101
When it runs · the whole SKILL.md, loaded when a task matches
~511

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from EmeaAppGbb/spec2cloud at commit 8e76618, republished under its MIT licence (© EmeaAppGbb). 126 words, ~511 tokens.

Download SKILL.mdSave it as .claude/skills/deploy-diagnostics/SKILL.md (or your agent's skills folder).
name
deploy-diagnostics
description
Diagnose and resolve Azure deployment failures by analyzing error output, checking Azure resource state, and suggesting fixes. Use when azd provision fails, azd deploy fails, smoke tests fail against live deployment, container images fail to push/pull, or any Phase 6 deployment error occurs. Trigger on deployment errors, infrastructure failures, or post-deploy smoke test failures.

Deploy Diagnostics

Diagnose and resolve Azure deployment failures.

Steps

  1. Parse error output — Identify the error type from AZD stdout/stderr
  2. Classify the error — Match against known patterns (see below)
  3. Check resource state — Verify Azure resource health if accessible
  4. Suggest fix — Provide specific remediation
  5. Verify fix — After applying, re-run the failed command

Known Failure Patterns

PatternSymptomFix
Quota exceededQuotaExceeded in errorChange region or request quota increase
Name conflictConflictError or DNS takenUse a different environmentName
Image pull failureImagePullBackOffVerify ACR push succeeded and identity has AcrPull role
Bicep validationInvalidTemplateCheck infra/main.bicep syntax and parameter values
Permission deniedAuthorizationFailedVerify subscription access and required RBAC roles
Region unavailableLocationNotAvailableForResourceTypeDeploy to a supported region

Diagnostic Commands

bash
azd show                                                                    # deployment status
azd provision --debug                                                       # provisioning logs
az resource list --resource-group <rg-name> --output table                  # resource health
az containerapp logs show --name <app-name> --resource-group <rg-name>      # container app logs

Output Format

Error: <classification>
Root Cause: <description>
Fix: <specific action>
Confidence: HIGH | MEDIUM | LOW

© EmeaAppGbb, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .github/skills/deploy-diagnostics of EmeaAppGbb/spec2cloud.

Open the folder on GitHubat commit 8e76618

Compare with similar skills

Deploy Diagnostics next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Deploy Diagnostics compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deploy Diagnostics this skillEmeaAppGbb/spec2cloud100—~511Automated safety check: PassMIT
Backdoor Deploymentmicrosoft/Docker-Provider173—~7kAutomated safety check: PassCustom licence
DeerFlow Smoke Testbytedance/deer-flow83k—~2.5kAutomated safety check: NotesMIT
Onboarding Validationopen-edge-platform/edge-ai-suites140—~3.3kAutomated safety check: PassApache-2.0
Aspire DeploymentCommunityToolkit/Aspire629—~4.5kAutomated safety check: NotesMIT
Deploying To Azuremicrosoft-foundry/foundry-agent-webapp127—~2.2kAutomated safety check: WarnMIT

Similar skills

  • Backdoor Deployment

    microsoft/Docker-Provider

    Official

    Validate a container image change via backdoor deployment. An agent skill from microsoft/Docker-Provider.

    173 GitHub stars~7k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • DeerFlow Smoke Test

    bytedance/deer-flow

    Walks through an end-to-end smoke test of a DeerFlow deployment: pull the latest code, deploy with Docker or locally, verify services, run health checks and write a report.

    83k GitHub stars~2.5k tokensUpdated today
    Testing & QAAuto-check: notes
  • Onboarding Validation

    open-edge-platform/edge-ai-suites

    Validate the get-started experience of Open Edge Platform (OEP) software components from the perspective of a first-time user.

    140 GitHub stars~3.3k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Aspire Deployment

    CommunityToolkit/Aspire

    WORKFLOW SKILL — Deploy Aspire apps from AppHost models to Docker Compose, Kubernetes, Azure, AWS, or preview Radius.

    629 GitHub stars~4.5k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes
  • Deploying To Azure

    microsoft-foundry/foundry-agent-webapp

    Provides deployment commands and troubleshooting for Azure Container Apps.

    127 GitHub stars~2.2k tokensUpdated 5 mo ago
    DevOps & CloudAuto-check: warnings
  • Azure Anomaly Detector

    MicrosoftDocs/Agent-Skills

    Official

    Expert knowledge for Azure AI Anomaly Detector development including troubleshooting, best practices, limits & quotas, configuration, and deployment.

    775 GitHub stars~1.1k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed

More from EmeaAppGbb/spec2cloud

All 39 skills in this repo
  • Azure Deployment

    EmeaAppGbb/spec2cloud

    Provision Azure infrastructure, deploy to Azure Container Apps, and verify via smoke tests.

    100 GitHub stars~1.8k tokensUpdated 5 mo ago
    Auto-check passed
  • Contract Generation

    EmeaAppGbb/spec2cloud

    Generate API contracts, shared TypeScript types, and infrastructure resource definitions from Gherkin scenarios and test files.

    100 GitHub stars~1.6k tokensUpdated 5 mo ago
    Auto-check passed
  • Ddd Modeling

    EmeaAppGbb/spec2cloud

    Create Domain-Driven Design proposals from product specs or brownfield extraction outputs.

    100 GitHub stars~2.4k tokensUpdated 5 mo ago
    Auto-check passed
  • Implementation

    EmeaAppGbb/spec2cloud

    Write application code to make failing tests pass using contract-driven, slice-based architecture.

    100 GitHub stars~2.8k tokensUpdated 5 mo ago
    Auto-check passed
  • Spec Refinement

    EmeaAppGbb/spec2cloud

    Review PRDs and FRDs through product and technical lenses. An agent skill from EmeaAppGbb/spec2cloud.

    100 GitHub stars~2.2k tokensUpdated 5 mo ago
    Auto-check passed
  • State Management

    EmeaAppGbb/spec2cloud

    Read, write, and maintain .spec2cloud/state.json across phases and increments.

    100 GitHub stars~1.5k tokensUpdated 5 mo ago
    Auto-check passed

Works with

Questions about Deploy Diagnostics

What does Deploy Diagnostics do?

Diagnose and resolve Azure deployment failures by analyzing error output, checking Azure resource state, and suggesting fixes. Deploy Diagnostics is an agent skill from EmeaAppGbb/spec2cloud. Diagnose and resolve Azure deployment failures by analyzing error output, checking Azure resource state, and suggesting fixes.

When should I use Deploy Diagnostics?

Deploy Diagnostics fits situations like: azd provision fails; azd deploy fails; smoke tests fail against live deployment; container images fail to push/pull.

How do I install Deploy Diagnostics in Claude Code?

Run `npx skills add EmeaAppGbb/spec2cloud --skill deploy-diagnostics -a claude-code`. Or copy the skill folder (.github/skills/deploy-diagnostics in EmeaAppGbb/spec2cloud) into .claude/skills/deploy-diagnostics in your project. Claude Code loads it when a task matches its description.

How do I install Deploy Diagnostics in Codex?

Run `npx skills add EmeaAppGbb/spec2cloud --skill deploy-diagnostics -a codex`. Or copy the skill folder (.github/skills/deploy-diagnostics in EmeaAppGbb/spec2cloud) into .agents/skills/deploy-diagnostics in your project. Codex loads it when a task matches its description.

Can I use Deploy Diagnostics in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add EmeaAppGbb/spec2cloud --skill deploy-diagnostics -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/deploy-diagnostics, .gemini/skills/deploy-diagnostics, .github/skills/deploy-diagnostics and .opencode/skills/deploy-diagnostics in your project.

What does Deploy Diagnostics need to run?

Going by SKILL.md and its folder, Deploy Diagnostics needs the command-line tools its instructions call (az).

Does Deploy Diagnostics access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Deploy Diagnostics safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Deploy Diagnostics use?

Deploy Diagnostics is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Deploy Diagnostics use?

About 511 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Deploy Diagnostics?

Skills that share tags, products or a category with Deploy Diagnostics: Backdoor Deployment (microsoft/Docker-Provider, 173 stars), DeerFlow Smoke Test (bytedance/deer-flow, 83k stars), Onboarding Validation (open-edge-platform/edge-ai-suites, 140 stars) and Aspire Deployment (CommunityToolkit/Aspire, 629 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deploy Diagnostics?

EmeaAppGbb (a GitHub organization) maintains it in EmeaAppGbb/spec2cloud, which has 100 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on April 16, 2026.

Source: EmeaAppGbb/spec2cloud on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.