[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79WHWFAX01AF2C74GKT8J38":3,"skill-same:01M79WHWFAX01AF2C74GKT8J38":88},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":34,"updatedAt":35,"install":36,"resources":49},"01M79WHWFAX01AF2C74GKT8J38","aspire-deployment",null,"**WORKFLOW SKILL** — Deploy Aspire apps from AppHost models to Docker Compose, Kubernetes, Azure, AWS, or preview Radius. WHEN: \"deploy Aspire app\", \"publish Aspire artifacts\", \"deploy to Azure Container Apps\", \"generate Kubernetes artifacts\", \"deploy to Radius\", \"tear down Aspire deployment\". INVOKES: aspire CLI, Aspire docs, target cloud\u002Fcontainer CLIs. FOR SINGLE OPERATIONS: use generic Azure, Kubernetes, Docker, AWS, or Radius tools only when no Aspire AppHost exists.","Blind-Striker\u002Fagent-skills-and-plugins","Blind-Striker","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1965259?v=4","01M79WFXTE5PH0C1VB7B54ANMN","Deniz İrgin","01M79WFXV5KZ5GST1K8G035DM5",1,"MIT","https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fcodex\u002Fdeniz-dotnet-aspire\u002Fskills\u002Faspire-deployment\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: aspire-deployment\ndescription: '**WORKFLOW SKILL** — Deploy Aspire apps from AppHost models to\n  Docker Compose, Kubernetes, Azure, AWS, or preview Radius. WHEN: \"deploy\n  Aspire app\", \"publish Aspire artifacts\", \"deploy to Azure Container Apps\",\n  \"generate Kubernetes artifacts\", \"deploy to Radius\", \"tear down Aspire\n  deployment\". INVOKES: aspire CLI, Aspire docs, target cloud\u002Fcontainer CLIs.\n  FOR SINGLE OPERATIONS: use generic Azure, Kubernetes, Docker, AWS, or Radius\n  tools only when no Aspire AppHost exists.'\nlicense: MIT\nmetadata:\n  author: Microsoft\n  version: 0.0.5\n---\n\n# Aspire Deployment\n\nUse this skill when the task is to publish, preview, validate, deploy, or tear down an Aspire application deployment. This skill owns Aspire deployment routing. Do not start with a generic Azure, Docker, Kubernetes, Helm, or Bicep workflow until you have checked whether the workspace is an Aspire app.\n\nAspire deployment starts from the AppHost model. Treat `aspire deploy`, `aspire publish`, `aspire destroy`, `aspire do`, and the deployment environment resources in the AppHost as the primary path. Use stable SDK\u002Fhosting packages from the project's release family and matching preview builds for preview-only integrations such as Kubernetes and Radius.\n\nKeep this as one skill with target-specific references. Load only the reference files that match the target you discover or the user requests.\n\n## Routing precedence\n\nThis skill wins over generic cloud deployment skills when both conditions are true:\n\n1. The user asks to deploy, publish, generate deployment artifacts, create Bicep\u002FHelm\u002FCompose\u002FCDK output, host on Azure or AWS, deploy to Azure, AWS, Kubernetes, Docker Compose, or Radius, tear down deployed resources, or validate a deployment.\n2. The workspace has Aspire markers:\n   - Aspire workspace configuration\n   - C# or TypeScript AppHost files\n   - an AppHost project\n   - AppHost code using Aspire distributed application builder APIs\n\nIf Aspire markers are present but this skill was not automatically invoked, switch to this skill before continuing. Prefer Aspire CLI commands such as `aspire ls`, `aspire config list`, `aspire ps`, and `aspire describe` for workspace orientation.\n\n## Guiding principles\n\n### Use Aspire docs before changing deployment code\n\nBefore adding target packages, editing the AppHost, or using an unfamiliar deployment API, use Aspire docs:\n\n```bash\naspire docs search \"deploy with Aspire\"\naspire docs search \"Docker Compose deployment\"\naspire docs search \"Kubernetes deployment\"\naspire docs search \"Azure Container Apps deployment\"\naspire docs search \"Azure App Service deployment\"\naspire docs search \"Azure Kubernetes Service deployment\"\naspire docs search \"Radius deployment\"\naspire docs get \"deploy-to-azure-kubernetes-service-aks\"\naspire docs get \"\u003Cslug-from-search-results>\"\n```\n\nWhen you need exact C# or TypeScript API shape, use API docs too. Search both languages when you are not sure which AppHost language the repo uses:\n\n```bash\naspire docs api search \"\u003Cdeployment API or concept>\" --language csharp\naspire docs api search \"\u003Cdeployment API or concept>\" --language typescript\naspire docs api get \"\u003Cid-from-api-search>\"\n```\n\nDo not invent package names, builder methods, overloads, or deployment commands. API shapes differ between C# and TypeScript AppHosts.\n\n### Prefer Aspire-native deployment\n\nDeploy the resources declared in the AppHost, not the AppHost process itself.\nFor Docker Compose, configure the Compose environment and let Aspire generate services\nfor those resources; do not replace this with an AppHost Dockerfile or Compose service.\n\nUse Aspire deployment targets and CLI commands first:\n\n```bash\naspire publish --list-steps\naspire deploy --list-steps\naspire publish\naspire deploy\naspire destroy\naspire do \u003Cstep>\n```\n\nUse target-specific tooling only after Aspire has generated artifacts or when the target docs call for it:\n\n- Docker Compose: inspect generated `aspire-output\u002Fdocker-compose.yaml` and `.env*`; Aspire can also run `docker compose up` through `aspire deploy`.\n- Kubernetes: inspect generated Helm chart output; use Helm\u002Fkubectl when applying published artifacts yourself.\n- Azure: use `aspire add \u003Cazure-target>`, `aspire publish`, and `aspire deploy` through the AppHost deployment environment.\n- AWS: use `aspire add aws` to add the integration, inspect generated CDK\u002FCloudFormation output, and follow the AWS integrations repository guidance.\n- Radius: treat `Aspire.Hosting.Radius` as preview. Use integration\u002Fdocs search to verify\n  the package and API, then model `AddRadiusEnvironment(...).WithNamespace(...)`.\n\n### Ask where to deploy only when ambiguous\n\nDo not ask for target selection when the user already chose a target such as Docker Compose, Kubernetes, Azure Container Apps, Azure App Service, Azure Kubernetes Service (AKS), or AWS. Use the chosen target and continue with its reference.\n\nIf the user did not explicitly choose a deployment target and the AppHost does not already contain exactly one deployment environment, ask where they want to deploy before adding integrations, editing the AppHost, publishing artifacts, or deploying. Use a single multiple-choice question:\n\n> Where do you want to deploy this Aspire app?\n\nShow these choices:\n\n| Choice | Aspire add command | Use when |\n|--------|--------------------|----------|\n| Docker Compose | `aspire add docker` | The user wants local\u002Fserver container deployment artifacts for Docker or Podman. |\n| Kubernetes | `aspire add kubernetes` | The user has an existing Kubernetes cluster and wants Helm\u002FKubernetes artifacts or direct cluster deployment. |\n| Azure Container Apps | `aspire add azure-appcontainers` | The user wants an Azure-managed container platform for distributed apps and services. |\n| Azure App Service | `aspire add azure-appservice` | The user wants Azure website hosting for web apps\u002FAPIs that fit the App Service model. |\n| Azure Kubernetes Service (AKS) | `aspire add azure-kubernetes` | The user wants Aspire to provision and deploy to Azure-managed Kubernetes. |\n| AWS | `aspire add aws` | The user wants Aspire to publish\u002Fdeploy through the AWS Aspire integrations and AWS CDK. |\n\nDo not offer preview Radius as a default choice. Use it when the user explicitly requests\nRadius or the AppHost already contains a Radius environment.\n\nIf the user says only \"Azure\", ask again with just the Azure choices: Azure Container Apps, Azure App Service, or Azure Kubernetes Service (AKS). If the AppHost already contains exactly one deployment environment and the user did not ask to change targets, use that target and tell the user what was detected.\n\n### Ask before creating cloud resources when intent is not explicit\n\nCloud deploys can create billable resources. If the user asked for a plan, preview, validation, or \"make this deployable\", stop after the deployment plan\u002Fartifacts and ask before running the command that provisions resources.\n\nIf the user explicitly asked to deploy now, continue through preflight and deployment, but still surface any target choice, subscription\u002Fresource group ambiguity, or missing parameter decisions before provisioning.\n\n### Keep Azure deployment Aspire-native\n\nThe Azure deployment path in this skill is `aspire add \u003Cazure-target>`, AppHost environment configuration, `aspire publish`, and `aspire deploy`. Do not route Azure deployment work through a separate Azure deployment tool or generated infrastructure workflow.\n\n### Keep Aspire packages on one release family\n\nBefore publish or deploy, verify that `Aspire.AppHost.Sdk` and the hosting packages use\ncompatible versions in the project's selected release family. Preview-only integrations\nneed compatible preview builds selected by `aspire add` or integration docs.\nThe CLI version does not make incompatible hosting packages safe; mixed graphs can\nfail at startup with `MissingMethodException` or `TypeLoadException`.\n\nMigrate obsolete 13.5 surfaces while editing deployment code:\n\n- use `.Services` instead of hosting context `.ServiceProvider`;\n- use `AddConnectionString` instead of `PublishAsConnectionString`; and\n- migrate deprecated `Aspire.Hosting.GitHub.Models` resources to Azure AI Foundry.\n\n## Default workflow\n\n1. **Orient to the Aspire workspace.**\n   - Start with `aspire ls` to list AppHosts in the current scope, then use `aspire.config.json`, AppHost project files, or `aspire ps` if more context is needed.\n   - If no AppHost exists, stop deployment work and invoke the `$deniz-dotnet-aspire:aspireify` skill to initialize\u002Fwire the AppHost before continuing.\n   - Identify C# vs TypeScript AppHost.\n   - Prefer Aspire CLI commands for discovery and state inspection.\n2. **Clarify or infer the deployment target.**\n   - If the user named Docker Compose, Kubernetes, Azure Container Apps, Azure App Service, Azure Kubernetes Service (AKS), or AWS, load that target reference without asking again.\n   - If they only said \"deploy\", inspect existing AppHost target environment resources.\n   - If exactly one target environment already exists, use it and state what was detected.\n   - If multiple targets exist, none exists, or the user says only \"Azure\", ask where to deploy using the choices above.\n3. **Load target and app-type references.**\n    - Docker Compose: [references\u002Fdocker-compose.md](references\u002Fdocker-compose.md)\n    - Kubernetes and Azure Kubernetes Service (AKS): [references\u002Fkubernetes.md](references\u002Fkubernetes.md)\n    - Azure Container Apps\u002FApp Service\u002FAzure Kubernetes Service (AKS): [references\u002Fazure.md](references\u002Fazure.md)\n    - AWS: [references\u002Faws.md](references\u002Faws.md)\n    - Radius preview: use current Aspire docs and API search for `Aspire.Hosting.Radius`;\n      do not guess experimental API shapes.\n    - JavaScript app resources: [references\u002Fjavascript.md](references\u002Fjavascript.md)\n    - CI\u002FCD or GitHub Actions automation: [references\u002Fcicd.md](references\u002Fcicd.md)\n4. **Use Aspire docs search for current guidance.**\n    - Search and get the target deployment docs.\n    - Search API docs before editing AppHost code.\n5. **Apply the target code changes.**\n   - Run the target's `aspire add ...` command if the integration is missing.\n   - Add the deployment environment resource to the AppHost.\n   - Do not add explicit compute-environment assignment for the common single-environment case. Only disambiguate when the AppHost has multiple deployment environments. In C# this is usually `WithComputeEnvironment(...)`; for TypeScript AppHosts, verify the current language-specific docs before assuming an equivalent.\n   - Add only the target-specific customization APIs the deployment needs, such as endpoint exposure, Helm settings, Compose file customization, Azure site\u002Fcontainer app customization, or AWS publish target overrides.\n6. **Preflight the deployment model.**\n   - Confirm the target integration package exists in the AppHost.\n   - Confirm the AppHost has the target environment resource.\n   - Confirm compute resources are assigned to the target environment only when multiple compute environments exist. A single compute environment is the common case and can be inferred.\n   - Inventory parameters, secrets, connection strings, external endpoints, container registries, and target-specific prerequisites.\n   - For Azure or AWS, confirm auth, target account\u002Fsubscription, region\u002Flocation, and resource group\u002Fstack context.\n7. **Preview before applying.**\n   - Run `aspire publish --list-steps` or `aspire deploy --list-steps`.\n   - Use `aspire publish -o \u003Cscratch-or-output-path>` when artifact review is requested.\n   - Treat published artifacts as a preview\u002Fhandoff. `aspire deploy` resolves values and applies the deployment from the AppHost model; it does not consume a previously published output directory.\n   - Summarize resources, endpoints, parameters, secrets, identities, and generated artifacts.\n8. **Deploy or hand off.**\n   - Run `aspire deploy` when the user asked to deploy and preflight is complete.\n   - Run a named step with `aspire do \u003Cstep>` only when the user asked for a specific pipeline step.\n   - For published artifacts, explain the target-native apply step.\n9. **Destroy only when explicitly requested.**\n   - Run `aspire destroy` to execute the selected AppHost\u002Fenvironment's target destroy pipeline.\n   - Confirm the AppHost, environment, target account\u002Fsubscription\u002Fcluster, and destructive intent before running it.\n   - Use `--yes` only when the user or CI workflow already made teardown intent explicit.\n   - Prefer `aspire destroy` over target-native delete commands unless you are troubleshooting failed teardown or cleaning up unmanaged leftovers.\n10. **Verify the outcome.**\n   - Use target output, `aspire describe`, cloud CLI, Docker Compose, kubectl, or endpoint checks appropriate to the target.\n   - After destroy, verify target resources are removed or record any leftovers that require manual cleanup.\n\n## AppHost target detection\n\nSearch the AppHost for deployment environment resources:\n\n| Target | Aspire add command | Integration | AppHost environment concept |\n|--------|--------------------|-------------|-----------------------------|\n| Docker Compose | `aspire add docker` | Docker hosting | Docker Compose environment |\n| Kubernetes | `aspire add kubernetes` | Kubernetes hosting | Kubernetes environment |\n| Azure Container Apps | `aspire add azure-appcontainers` | Azure Container Apps hosting | Azure Container Apps environment |\n| Azure App Service | `aspire add azure-appservice` | Azure App Service hosting | Azure App Service environment |\n| Azure Kubernetes Service (AKS) | `aspire add azure-kubernetes` | Azure Kubernetes hosting | Azure Kubernetes Service (AKS) environment |\n| AWS | `aspire add aws` | AWS hosting | AWS CDK environment |\n| Radius (preview) | Discover with `aspire integration search radius` | `Aspire.Hosting.Radius` | Radius environment |\n\nUse this table only for orientation. Before editing code, verify the current API in Aspire docs for the AppHost language.\n\n## Parameter and secret preflight\n\nParameters are deployment inputs. They may be supplied by configuration files, user secrets, environment variables, command-line args, interactive prompts, or CI\u002FCD secret stores depending on the target and command.\n\nBefore deployment, report:\n\n- Parameter name from AppHost parameter APIs, including config-backed parameters\n- Whether it is secret\n- Expected provider syntax such as `Parameters__name`; for parameter names with dashes, use underscores in environment variables, for example `registry-endpoint` becomes `Parameters__registry_endpoint`\n- Where it flows, such as a project environment variable, connection string, Key Vault secret, Helm Secret, Compose `.env`, or Azure app setting\n- Whether a value appears configured or missing\n\nUse `aspire secret list` for AppHost user secrets when appropriate, but do not print secret values. For deployment artifacts, inspect generated placeholders and mappings, not raw secret content.\n\n## Target references\n\n- [references\u002Fdocker-compose.md](references\u002Fdocker-compose.md) - Docker Compose target, generated files, environment variables, cleanup.\n- [references\u002Fkubernetes.md](references\u002Fkubernetes.md) - Kubernetes and Azure Kubernetes Service (AKS) target selection, Helm output, registry requirements, kubectl\u002FHelm checks.\n- [references\u002Fazure.md](references\u002Fazure.md) - Azure target selection, Azure settings, Container Apps, App Service, and Azure Kubernetes Service (AKS).\n- [references\u002Faws.md](references\u002Faws.md) - AWS target selection, AWS CDK prerequisites, publish\u002Fdeploy workflow, and AWS integration docs.\n- [references\u002Fjavascript.md](references\u002Fjavascript.md) - JavaScript app deployment models, including Vite\u002Fstatic assets, Node\u002FSSR servers, Next.js, and gateway\u002Fbackend serving patterns.\n- [references\u002Fcicd.md](references\u002Fcicd.md) - CI\u002FCD and GitHub Actions workflow guidance for Aspire publish\u002Fdeploy, parameters, secrets, registry auth, and cloud auth.\n- [references\u002Fpreflight.md](references\u002Fpreflight.md) - Common preflight, preview, parameter, destroy, and validation checklist.\n- [aspire-13-5-breaking-changes.md](..\u002Faspire\u002Freferences\u002Faspire-13-5-breaking-changes.md) - 13.5 package, API, and CLI migration rules.\n\n## Agent execution\n\nWhen running unattended (CI, scripted, agent-driven), append `--non-interactive` to every Aspire CLI invocation that may prompt — most importantly `aspire publish`, `aspire deploy`, and `aspire destroy`. For `aspire destroy`, also pass `--yes` only after the user has explicitly confirmed teardown intent (or a CI workflow already encodes that intent).\n\nPrefer surfacing prompt-driving values up front (target subscription\u002Fregion\u002Fresource group, parameters, secrets, registry credentials) so the unattended run does not stall. See [references\u002Fpreflight.md](references\u002Fpreflight.md) for the full preflight checklist.\n\n## Handoff Rules\n\n| Scenario | Route To |\n|----------|----------|\n| Start, stop, wait, or restart the AppHost \u002F its resources | `$deniz-dotnet-aspire:aspire-orchestration` skill |\n| Logs, traces, metrics, dashboard for a running or deployed app | `$deniz-dotnet-aspire:aspire-monitoring` skill |\n| AppHost authoring — adding integrations, wiring resources, environment setup | `$deniz-dotnet-aspire:aspireify` skill |\n| Deployed-app diagnostics — App Insights, ACA logs, AKS Container Insights | `azure-diagnostics` skill (azure-skills) |\n\n> Never hand deployment off to azure-skills. Aspire handles publish, deploy, and destroy\n> end-to-end across Docker Compose \u002F Kubernetes \u002F Azure \u002F AWS via the AppHost model.\n\n## Project-Local Skill Override\n\nIf `.agents\u002Fskills\u002Faspire-deployment\u002FSKILL.md` exists (dropped by `aspire agent init`),\nprefer it over this plugin skill — it is the authoritative project-local version with\ncontent version-aligned to the consumer's Aspire CLI. This plugin skill is the always-on\nsafety net for repos that have not yet run `aspire agent init`.\n","# Aspire Deployment\n\nUse this skill when the task is to publish, preview, validate, deploy, or tear down an Aspire application deployment. This skill owns Aspire deployment routing. Do not start with a generic Azure, Docker, Kubernetes, Helm, or Bicep workflow until you have checked whether the workspace is an Aspire app.\n\nAspire deployment starts from the AppHost model. Treat `aspire deploy`, `aspire publish`, `aspire destroy`, `aspire do`, and the deployment environment resources in the AppHost as the primary path. Use stable SDK\u002Fhosting packages from the project's release family and matching preview builds for preview-only integrations such as Kubernetes and Radius.\n\nKeep this as one skill with target-specific references. Load only the reference files that match the target you discover or the user requests.\n\n## Routing precedence\n\nThis skill wins over generic cloud deployment skills when both conditions are true:\n\n1. The user asks to deploy, publish, generate deployment artifacts, create Bicep\u002FHelm\u002FCompose\u002FCDK output, host on Azure or AWS, deploy to Azure, AWS, Kubernetes, Docker Compose, or Radius, tear down deployed resources, or validate a deployment.\n2. The workspace has Aspire markers:\n   - Aspire workspace configuration\n   - C# or TypeScript AppHost files\n   - an AppHost project\n   - AppHost code using Aspire distributed application builder APIs\n\nIf Aspire markers are present but this skill was not automatically invoked, switch to this skill before continuing. Prefer Aspire CLI commands such as `aspire ls`, `aspire config list`, `aspire ps`, and `aspire describe` for workspace orientation.\n\n## Guiding principles\n\n### Use Aspire docs before changing deployment code\n\nBefore adding target packages, editing the AppHost, or using an unfamiliar deployment API, use Aspire docs:\n\n```bash\naspire docs search \"deploy with Aspire\"\naspire docs search \"Docker Compose deployment\"\naspire docs search \"Kubernetes deployment\"\naspire docs search \"Azure Container Apps deployment\"\naspire docs search \"Azure App Service deployment\"\naspire docs search \"Azure Kubernetes Service deployment\"\naspire docs search \"Radius deployment\"\naspire docs get \"deploy-to-azure-kubernetes-service-aks\"\naspire docs get \"\u003Cslug-from-search-results>\"\n```\n\nWhen you need exact C# or TypeScript API shape, use API docs too. Search both languages when you are not sure which AppHost language the repo uses:\n\n```bash\naspire docs api search \"\u003Cdeployment API or concept>\" --language csharp\naspire docs api search \"\u003Cdeployment API or concept>\" --language typescript\naspire docs api get \"\u003Cid-from-api-search>\"\n```\n\nDo not invent package names, builder methods, overloads, or deployment commands. API shapes differ between C# and TypeScript AppHosts.\n\n### Prefer Aspire-native deployment\n\nDeploy the resources declared in the AppHost, not the AppHost process itself.\nFor Docker Compose, configure the Compose environment and let Aspire generate services\nfor those resources; do not replace this with an AppHost Dockerfile or Compose service.\n\nUse Aspire deployment targets and CLI commands first:\n\n```bash\naspire publish --list-steps\naspire deploy --list-steps\naspire publish\naspire deploy\naspire destroy\naspire do \u003Cstep>\n```\n\nUse target-specific tooling only after Aspire has generated artifacts or when the target docs call for it:\n\n- Docker Compose: inspect generated `aspire-output\u002Fdocker-compose.yaml` and `.env*`; Aspire can also run `docker compose up` through `aspire deploy`.\n- Kubernetes: inspect generated Helm chart output; use Helm\u002Fkubectl when applying published artifacts yourself.\n- Azure: use `aspire add \u003Cazure-target>`, `aspire publish`, and `aspire deploy` through the AppHost deployment environment.\n- AWS: use `aspire add aws` to add the integration, inspect generated CDK\u002FCloudFormation output, and follow the AWS integrations repository guidance.\n- Radius: treat `Aspire.Hosting.Radius` as preview. Use integration\u002Fdocs search to verify\n  the package and API, then model `AddRadiusEnvironment(...).WithNamespace(...)`.\n\n### Ask where to deploy only when ambiguous\n\nDo not ask for target selection when the user already chose a target such as Docker Compose, Kubernetes, Azure Container Apps, Azure App Service, Azure Kubernetes Service (AKS), or AWS. Use the chosen target and continue with its reference.\n\nIf the user did not explicitly choose a deployment target and the AppHost does not already contain exactly one deployment environment, ask where they want to deploy before adding integrations, editing the AppHost, publishing artifacts, or deploying. Use a single multiple-choice question:\n\n> Where do you want to deploy this Aspire app?\n\nShow these choices:\n\n| Choice | Aspire add command | Use when |\n|--------|--------------------|----------|\n| Docker Compose | `aspire add docker` | The user wants local\u002Fserver container deployment artifacts for Docker or Podman. |\n| Kubernetes | `aspire add kubernetes` | The user has an existing Kubernetes cluster and wants Helm\u002FKubernetes artifacts or direct cluster deployment. |\n| Azure Container Apps | `aspire add azure-appcontainers` | The user wants an Azure-managed container platform for distributed apps and services. |\n| Azure App Service | `aspire add azure-appservice` | The user wants Azure website hosting for web apps\u002FAPIs that fit the App Service model. |\n| Azure Kubernetes Service (AKS) | `aspire add azure-kubernetes` | The user wants Aspire to provision and deploy to Azure-managed Kubernetes. |\n| AWS | `aspire add aws` | The user wants Aspire to publish\u002Fdeploy through the AWS Aspire integrations and AWS CDK. |\n\nDo not offer preview Radius as a default choice. Use it when the user explicitly requests\nRadius or the AppHost already contains a Radius environment.\n\nIf the user says only \"Azure\", ask again with just the Azure choices: Azure Container Apps, Azure App Service, or Azure Kubernetes Service (AKS). If the AppHost already contains exactly one deployment environment and the user did not ask to change targets, use that target and tell the user what was detected.\n\n### Ask before creating cloud resources when intent is not explicit\n\nCloud deploys can create billable resources. If the user asked for a plan, preview, validation, or \"make this deployable\", stop after the deployment plan\u002Fartifacts and ask before running the command that provisions resources.\n\nIf the user explicitly asked to deploy now, continue through preflight and deployment, but still surface any target choice, subscription\u002Fresource group ambiguity, or missing parameter decisions before provisioning.\n\n### Keep Azure deployment Aspire-native\n\nThe Azure deployment path in this skill is `aspire add \u003Cazure-target>`, AppHost environment configuration, `aspire publish`, and `aspire deploy`. Do not route Azure deployment work through a separate Azure deployment tool or generated infrastructure workflow.\n\n### Keep Aspire packages on one release family\n\nBefore publish or deploy, verify that `Aspire.AppHost.Sdk` and the hosting packages use\ncompatible versions in the project's selected release family. Preview-only integrations\nneed compatible preview builds selected by `aspire add` or integration docs.\nThe CLI version does not make incompatible hosting packages safe; mixed graphs can\nfail at startup with `MissingMethodException` or `TypeLoadException`.\n\nMigrate obsolete 13.5 surfaces while editing deployment code:\n\n- use `.Services` instead of hosting context `.ServiceProvider`;\n- use `AddConnectionString` instead of `PublishAsConnectionString`; and\n- migrate deprecated `Aspire.Hosting.GitHub.Models` resources to Azure AI Foundry.\n\n## Default workflow\n\n1. **Orient to the Aspire workspace.**\n   - Start with `aspire ls` to list AppHosts in the current scope, then use `aspire.config.json`, AppHost project files, or `aspire ps` if more context is needed.\n   - If no AppHost exists, stop deployment work and invoke the `$deniz-dotnet-aspire:aspireify` skill to initialize\u002Fwire the AppHost before continuing.\n   - Identify C# vs TypeScript AppHost.\n   - Prefer Aspire CLI commands for discovery and state inspection.\n2. **Clarify or infer the deployment target.**\n   - If the user named Docker Compose, Kubernetes, Azure Container Apps, Azure App Service, Azure Kubernetes Service (AKS), or AWS, load that target reference without asking again.\n   - If they only said \"deploy\", inspect existing AppHost target environment resources.\n   - If exactly one target environment already exists, use it and state what was detected.\n   - If multiple targets exist, none exists, or the user says only \"Azure\", ask where to deploy using the choices above.\n3. **Load target and app-type references.**\n    - Docker Compose: [references\u002Fdocker-compose.md](references\u002Fdocker-compose.md)\n    - Kubernetes and Azure Kubernetes Service (AKS): [references\u002Fkubernetes.md](references\u002Fkubernetes.md)\n    - Azure Container Apps\u002FApp Service\u002FAzure Kubernetes Service (AKS): [references\u002Fazure.md](references\u002Fazure.md)\n    - AWS: [references\u002Faws.md](references\u002Faws.md)\n    - Radius preview: use current Aspire docs and API search for `Aspire.Hosting.Radius`;\n      do not guess experimental API shapes.\n    - JavaScript app resources: [references\u002Fjavascript.md](references\u002Fjavascript.md)\n    - CI\u002FCD or GitHub Actions automation: [references\u002Fcicd.md](references\u002Fcicd.md)\n4. **Use Aspire docs search for current guidance.**\n    - Search and get the target deployment docs.\n    - Search API docs before editing AppHost code.\n5. **Apply the target code changes.**\n   - Run the target's `aspire add ...` command if the integration is missing.\n   - Add the deployment environment resource to the AppHost.\n   - Do not add explicit compute-environment assignment for the common single-environment case. Only disambiguate when the AppHost has multiple deployment environments. In C# this is usually `WithComputeEnvironment(...)`; for TypeScript AppHosts, verify the current language-specific docs before assuming an equivalent.\n   - Add only the target-specific customization APIs the deployment needs, such as endpoint exposure, Helm settings, Compose file customization, Azure site\u002Fcontainer app customization, or AWS publish target overrides.\n6. **Preflight the deployment model.**\n   - Confirm the target integration package exists in the AppHost.\n   - Confirm the AppHost has the target environment resource.\n   - Confirm compute resources are assigned to the target environment only when multiple compute environments exist. A single compute environment is the common case and can be inferred.\n   - Inventory parameters, secrets, connection strings, external endpoints, container registries, and target-specific prerequisites.\n   - For Azure or AWS, confirm auth, target account\u002Fsubscription, region\u002Flocation, and resource group\u002Fstack context.\n7. **Preview before applying.**\n   - Run `aspire publish --list-steps` or `aspire deploy --list-steps`.\n   - Use `aspire publish -o \u003Cscratch-or-output-path>` when artifact review is requested.\n   - Treat published artifacts as a preview\u002Fhandoff. `aspire deploy` resolves values and applies the deployment from the AppHost model; it does not consume a previously published output directory.\n   - Summarize resources, endpoints, parameters, secrets, identities, and generated artifacts.\n8. **Deploy or hand off.**\n   - Run `aspire deploy` when the user asked to deploy and preflight is complete.\n   - Run a named step with `aspire do \u003Cstep>` only when the user asked for a specific pipeline step.\n   - For published artifacts, explain the target-native apply step.\n9. **Destroy only when explicitly requested.**\n   - Run `aspire destroy` to execute the selected AppHost\u002Fenvironment's target destroy pipeline.\n   - Confirm the AppHost, environment, target account\u002Fsubscription\u002Fcluster, and destructive intent before running it.\n   - Use `--yes` only when the user or CI workflow already made teardown intent explicit.\n   - Prefer `aspire destroy` over target-native delete commands unless you are troubleshooting failed teardown or cleaning up unmanaged leftovers.\n10. **Verify the outcome.**\n   - Use target output, `aspire describe`, cloud CLI, Docker Compose, kubectl, or endpoint checks appropriate to the target.\n   - After destroy, verify target resources are removed or record any leftovers that require manual cleanup.\n\n## AppHost target detection\n\nSearch the AppHost for deployment environment resources:\n\n| Target | Aspire add command | Integration | AppHost environment concept |\n|--------|--------------------|-------------|-----------------------------|\n| Docker Compose | `aspire add docker` | Docker hosting | Docker Compose environment |\n| Kubernetes | `aspire add kubernetes` | Kubernetes hosting | Kubernetes environment |\n| Azure Container Apps | `aspire add azure-appcontainers` | Azure Container Apps hosting | Azure Container Apps environment |\n| Azure App Service | `aspire add azure-appservice` | Azure App Service hosting | Azure App Service environment |\n| Azure Kubernetes Service (AKS) | `aspire add azure-kubernetes` | Azure Kubernetes hosting | Azure Kubernetes Service (AKS) environment |\n| AWS | `aspire add aws` | AWS hosting | AWS CDK environment |\n| Radius (preview) | Discover with `aspire integration search radius` | `Aspire.Hosting.Radius` | Radius environment |\n\nUse this table only for orientation. Before editing code, verify the current API in Aspire docs for the AppHost language.\n\n## Parameter and secret preflight\n\nParameters are deployment inputs. They may be supplied by configuration files, user secrets, environment variables, command-line args, interactive prompts, or CI\u002FCD secret stores depending on the target and command.\n\nBefore deployment, report:\n\n- Parameter name from AppHost parameter APIs, including config-backed parameters\n- Whether it is secret\n- Expected provider syntax such as `Parameters__name`; for parameter names with dashes, use underscores in environment variables, for example `registry-endpoint` becomes `Parameters__registry_endpoint`\n- Where it flows, such as a project environment variable, connection string, Key Vault secret, Helm Secret, Compose `.env`, or Azure app setting\n- Whether a value appears configured or missing\n\nUse `aspire secret list` for AppHost user secrets when appropriate, but do not print secret values. For deployment artifacts, inspect generated placeholders and mappings, not raw secret content.\n\n## Target references\n\n- [references\u002Fdocker-compose.md](references\u002Fdocker-compose.md) - Docker Compose target, generated files, environment variables, cleanup.\n- [references\u002Fkubernetes.md](references\u002Fkubernetes.md) - Kubernetes and Azure Kubernetes Service (AKS) target selection, Helm output, registry requirements, kubectl\u002FHelm checks.\n- [references\u002Fazure.md](references\u002Fazure.md) - Azure target selection, Azure settings, Container Apps, App Service, and Azure Kubernetes Service (AKS).\n- [references\u002Faws.md](references\u002Faws.md) - AWS target selection, AWS CDK prerequisites, publish\u002Fdeploy workflow, and AWS integration docs.\n- [references\u002Fjavascript.md](references\u002Fjavascript.md) - JavaScript app deployment models, including Vite\u002Fstatic assets, Node\u002FSSR servers, Next.js, and gateway\u002Fbackend serving patterns.\n- [references\u002Fcicd.md](references\u002Fcicd.md) - CI\u002FCD and GitHub Actions workflow guidance for Aspire publish\u002Fdeploy, parameters, secrets, registry auth, and cloud auth.\n- [references\u002Fpreflight.md](references\u002Fpreflight.md) - Common preflight, preview, parameter, destroy, and validation checklist.\n- [aspire-13-5-breaking-changes.md](..\u002Faspire\u002Freferences\u002Faspire-13-5-breaking-changes.md) - 13.5 package, API, and CLI migration rules.\n\n## Agent execution\n\nWhen running unattended (CI, scripted, agent-driven), append `--non-interactive` to every Aspire CLI invocation that may prompt — most importantly `aspire publish`, `aspire deploy`, and `aspire destroy`. For `aspire destroy`, also pass `--yes` only after the user has explicitly confirmed teardown intent (or a CI workflow already encodes that intent).\n\nPrefer surfacing prompt-driving values up front (target subscription\u002Fregion\u002Fresource group, parameters, secrets, registry credentials) so the unattended run does not stall. See [references\u002Fpreflight.md](references\u002Fpreflight.md) for the full preflight checklist.\n\n## Handoff Rules\n\n| Scenario | Route To |\n|----------|----------|\n| Start, stop, wait, or restart the AppHost \u002F its resources | `$deniz-dotnet-aspire:aspire-orchestration` skill |\n| Logs, traces, metrics, dashboard for a running or deployed app | `$deniz-dotnet-aspire:aspire-monitoring` skill |\n| AppHost authoring — adding integrations, wiring resources, environment setup | `$deniz-dotnet-aspire:aspireify` skill |\n| Deployed-app diagnostics — App Insights, ACA logs, AKS Container Insights | `azure-diagnostics` skill (azure-skills) |\n\n> Never hand deployment off to azure-skills. Aspire handles publish, deploy, and destroy\n> end-to-end across Docker Compose \u002F Kubernetes \u002F Azure \u002F AWS via the AppHost model.\n\n## Project-Local Skill Override\n\nIf `.agents\u002Fskills\u002Faspire-deployment\u002FSKILL.md` exists (dropped by `aspire agent init`),\nprefer it over this plugin skill — it is the authoritative project-local version with\ncontent version-aligned to the consumer's Aspire CLI. This plugin skill is the always-on\nsafety net for repos that have not yet run `aspire agent init`.\n",{"name":5,"license":15,"metadata":24,"description":7},{"author":25,"version":26},"Microsoft","0.0.5","master","b30b1c1908dbc56a8184128f18803053d762ccb5","codex\u002Fdeniz-dotnet-aspire\u002Fskills\u002Faspire-deployment",0,"https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins","https:\u002F\u002Fgithub.com\u002FBlind-Striker","denizirgin.com","VP of Engineering - \r\n@armutcom @homeruntech @prontopro\r\n |  Speaker \r\n@CodeFiction\r\n, http:\u002F\u002Fcodefiction.tech | Developer, gamer, blogger, maiden iron fan","2026-11-13 00:23:18",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add Blind-Striker\u002Fagent-skills-and-plugins --skill aspire-deployment",{"tool":42,"command":43},"bunx","bunx skills add Blind-Striker\u002Fagent-skills-and-plugins --skill aspire-deployment",{"tool":45,"command":46},"pnpm","pnpm dlx skills add Blind-Striker\u002Fagent-skills-and-plugins --skill aspire-deployment","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fcodex\u002Fdeniz-dotnet-aspire\u002Fskills\u002Faspire-deployment\u002FSKILL.md",true,[50,56,60,64,68,72,76,80,84],{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Faws.md","REFERENCE","参考文档",8678,"https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fcodex\u002Fdeniz-dotnet-aspire\u002Fskills\u002Faspire-deployment\u002Freferences\u002Faws.md",{"path":57,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":58,"sourceHtmlUrl":59},"references\u002Fazure.md",20740,"https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fcodex\u002Fdeniz-dotnet-aspire\u002Fskills\u002Faspire-deployment\u002Freferences\u002Fazure.md",{"path":61,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":62,"sourceHtmlUrl":63},"references\u002Fcicd.md",14879,"https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fcodex\u002Fdeniz-dotnet-aspire\u002Fskills\u002Faspire-deployment\u002Freferences\u002Fcicd.md",{"path":65,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":66,"sourceHtmlUrl":67},"references\u002Fdocker-compose.md",7509,"https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fcodex\u002Fdeniz-dotnet-aspire\u002Fskills\u002Faspire-deployment\u002Freferences\u002Fdocker-compose.md",{"path":69,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":70,"sourceHtmlUrl":71},"references\u002Fgithub-actions-azure-csharp.yml",1594,"https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fcodex\u002Fdeniz-dotnet-aspire\u002Fskills\u002Faspire-deployment\u002Freferences\u002Fgithub-actions-azure-csharp.yml",{"path":73,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":74,"sourceHtmlUrl":75},"references\u002Fgithub-actions-azure-typescript.yml",1560,"https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fcodex\u002Fdeniz-dotnet-aspire\u002Fskills\u002Faspire-deployment\u002Freferences\u002Fgithub-actions-azure-typescript.yml",{"path":77,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":78,"sourceHtmlUrl":79},"references\u002Fjavascript.md",8136,"https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fcodex\u002Fdeniz-dotnet-aspire\u002Fskills\u002Faspire-deployment\u002Freferences\u002Fjavascript.md",{"path":81,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":82,"sourceHtmlUrl":83},"references\u002Fkubernetes.md",14495,"https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fcodex\u002Fdeniz-dotnet-aspire\u002Fskills\u002Faspire-deployment\u002Freferences\u002Fkubernetes.md",{"path":85,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":86,"sourceHtmlUrl":87},"references\u002Fpreflight.md",9895,"https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fcodex\u002Fdeniz-dotnet-aspire\u002Fskills\u002Faspire-deployment\u002Freferences\u002Fpreflight.md",[89,96,103,110,117,124],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M79YGWBJ52PHMSTKJ3RJ3AWR","writing-tunit-tests","Write tests in TUnit — the attributes, the async assertion model, data-driven cases, lifecycle hooks, and the parallelism rules. USE FOR writing or fixing a test in a TUnit project, translating a test idea into TUnit syntax, or reviewing TUnit test code for API mistakes. DO NOT USE FOR deciding what to test, judging whether a test is any good, or running tests.","https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fskills\u002Fdeniz-dotnet-general\u002Fwriting-tunit-tests\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M79YGR3Y9RCRS6TD71D0KKP8","dotnet-walls","Walls for a .NET change in a repository without its own quality gates — pinned, ephemeral analyzer, format, clone and scanner commands for the verify step, their identity ratchet, and the build traps. Use during a walls preflight, or when a worker's verify step needs .NET quality gates.","https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fskills\u002Fdeniz-dotnet-general\u002Fdotnet-walls\u002FSKILL.md",[],[],{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":19},"01M79YGFNJBST7D803NQW3SBYM","csharp-15","Write, review and modernize C# 15 (.NET 11) code correctly. Covers every C# 15 feature - collection expression arguments (`[with(...), ...]`), union types (`union`, `[Union]`, `IUnion`, custom unions), closed class hierarchies (`closed`), extension indexers, labeled `break`\u002F`continue`, non-virtual static interface members on runtimes without default interface methods, and the preview memory-safety model (`unsafe(expr)`, `safe`, requires-unsafe members). Use when code targets net11.0 or LangVersion 15\u002Fpreview, when the user mentions any of these features, when replacing marker interfaces, OneOf-style results, `goto`\u002Fflag loop exits or capacity\u002Fcomparer boilerplate, or when the build reports CS8121, CS8509, CS8655, CS8510, CS0121\u002FCS0411 on a `with(...)` element, CS9370, CS9380 or CS9363.","https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fskills\u002Fdeniz-dotnet-general\u002Fcsharp-15\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":19},"01M79YGAV031473HSX6FN87ENH","verified-waves","Run one task as verified multi-agent waves. Plans the fan-out, sends findings to fresh skeptics, keeps a ledger, and reports N of M done; small tasks stay solo.","https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fskills\u002Fdeniz-coordination\u002Fverified-waves\u002FSKILL.md",[],[],{"skillNo":118,"name":119,"nameZh":6,"description":120,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":121,"categories":122,"keywords":123,"publishedAt":19},"01M79YG6QXNND4WRPP3GATSY8J","harness","The bundled dispatch harness, which runs a task file on worker models through OpenCode or Codex, fences their writes, escalates their asks to the operator, settles each result from git and its verify commands, and records every step in a ledger. Its commands, task file, modes and write fence, configuration, runs and their recovery, ledger and exit codes.","https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fskills\u002Fdeniz-coordination\u002Fharness\u002FSKILL.md",[],[],{"skillNo":125,"name":126,"nameZh":6,"description":127,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":128,"categories":129,"keywords":130,"publishedAt":19},"01M79YG2P5S91SDTA5912XJ4FV","delegating-to-worker-models","Use when you hand off implementation, a plan, research a decision will rely on, or a review, and you brief the worker and check what comes back. A subagent that searches, reads in parallel, or keeps your context small is ordinary tool use. Covers what stays with you, the mechanism, assigning work by strength, the walls preflight, prompts without contradictions, the worker contract and model profiles, evidence from your own run, review, and the fix-up loop.","https:\u002F\u002Fgithub.com\u002FBlind-Striker\u002Fagent-skills-and-plugins\u002Fblob\u002Fmaster\u002Fskills\u002Fdeniz-coordination\u002Fdelegating-to-worker-models\u002FSKILL.md",[],[]]