How do I install the Destroy HC AWS skill?

Run npx skillmds@latest add openshift/destroy-hc-aws in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Destroy HC AWS safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Destroy HC AWS?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Destroy HC AWS free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Destroy HC AWS?

openshift (@openshift) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Destroy HC AWS by openshift — Agent Skill

Name: Destroy HC AWS
Rating: 4.2 (5 reviews)
Author: openshift

File contents

Destroy HostedCluster

This skill destroys a HyperShift HostedCluster and all associated AWS infrastructure.

When to Use This Skill

Use this skill when:

You need to clean up a test HostedCluster
You want to destroy a HostedCluster and its AWS resources (VPC, subnets, NAT gateways, IAM roles, etc.)
You need to remove orphaned HostedClusters from previous test runs

Prerequisites

Source the environment file before using this skill:

source dev/claude-env.sh

Additional requirements:

AWS credentials loaded (source $AWS_CREDS_SOURCE)
KUBECONFIG pointing to management cluster ($MGMT_KUBECONFIG)
hypershift binary built (./bin/hypershift)

Environment Configuration

Environment variables from dev/claude-env.sh:

Variable	Description
`AWS_CREDENTIALS`	Path to AWS credentials file
`AWS_CREDS_SOURCE`	Script to source AWS env vars
`AWS_REGION`	AWS region
`MGMT_KUBECONFIG`	Path to management cluster kubeconfig

Command

source $AWS_CREDS_SOURCE && \
KUBECONFIG=$MGMT_KUBECONFIG \
./bin/hypershift destroy cluster aws \
  --name <CLUSTER_NAME> \
  --namespace <NAMESPACE> \
  --aws-creds $AWS_CREDENTIALS \
  --region $AWS_REGION

Parameters

Parameter	Description	Default
`--name`	Name of the HostedCluster to destroy	Required
`--namespace`	Namespace where the HostedCluster exists	`clusters`
`--aws-creds`	Path to AWS credentials file	`$AWS_CREDENTIALS`
`--region`	AWS region	`$AWS_REGION`

What Gets Destroyed

The command destroys:

HostedCluster and NodePool resources
HostedControlPlane namespace and all resources
AWS VPC and subnets
NAT gateways and internet gateways
Route tables
Security groups
DHCP options
Private hosted zones (Route53)
OIDC provider
IAM roles and instance profiles
VPC endpoints
Elastic IPs

Quick Cleanup for Orphaned HCs

If a HostedCluster is stuck deleting, you can force remove it:

# Remove cleanup annotation to skip cloud resource cleanup
KUBECONFIG=$MGMT_KUBECONFIG kubectl annotate hostedcluster <NAME> -n <NAMESPACE> \
  hypershift.openshift.io/cleanup-cloud-resources-

Example Usage

# List existing HostedClusters
KUBECONFIG=$MGMT_KUBECONFIG kubectl get hostedclusters -A

# Destroy a specific HostedCluster
source $AWS_CREDS_SOURCE && \
KUBECONFIG=$MGMT_KUBECONFIG \
./bin/hypershift destroy cluster aws \
  --name my-test-cluster \
  --namespace clusters \
  --aws-creds $AWS_CREDENTIALS \
  --region $AWS_REGION

Troubleshooting

NAT Gateway Still Deleting

NAT gateways take time to delete. The command will retry automatically.

VPC Has Dependencies

The command will retry until all dependencies (subnets, gateways, etc.) are deleted.

HostedCluster Stuck in Deleting

Check if there are stuck finalizers
Remove the cleanup-cloud-resources annotation if you want to skip AWS cleanup
Manually delete AWS resources if needed

---name: destroy-hc-awsdescription: Destroy a HyperShift HostedCluster and all associated AWS infrastructure (VPC, IAM, Route53, etc.).---# Destroy HostedClusterThis skill destroys a HyperShift HostedCluster and all associated AWS infrastructure.## When to Use This SkillUse this skill when:- You need to clean up a test HostedCluster- You want to destroy a HostedCluster and its AWS resources (VPC, subnets, NAT gateways, IAM roles, etc.)- You need to remove orphaned HostedClusters from previous test runs## PrerequisitesSource the environment file before using this skill:```bashsource dev/claude-env.sh```Additional requirements:- AWS credentials loaded (source `$AWS_CREDS_SOURCE`)- KUBECONFIG pointing to management cluster (`$MGMT_KUBECONFIG`)- hypershift binary built (`./bin/hypershift`)## Environment ConfigurationEnvironment variables from `dev/claude-env.sh`:| Variable | Description ||----------|-------------|| `AWS_CREDENTIALS` | Path to AWS credentials file || `AWS_CREDS_SOURCE` | Script to source AWS env vars || `AWS_REGION` | AWS region || `MGMT_KUBECONFIG` | Path to management cluster kubeconfig |## Command```bashsource $AWS_CREDS_SOURCE && \KUBECONFIG=$MGMT_KUBECONFIG \./bin/hypershift destroy cluster aws \ --name <CLUSTER_NAME> \ --namespace <NAMESPACE> \ --aws-creds $AWS_CREDENTIALS \ --region $AWS_REGION```## Parameters| Parameter | Description | Default ||-----------|-------------|---------|| `--name` | Name of the HostedCluster to destroy | Required || `--namespace` | Namespace where the HostedCluster exists | `clusters` || `--aws-creds` | Path to AWS credentials file | `$AWS_CREDENTIALS` || `--region` | AWS region | `$AWS_REGION` |## What Gets DestroyedThe command destroys:- HostedCluster and NodePool resources- HostedControlPlane namespace and all resources- AWS VPC and subnets- NAT gateways and internet gateways- Route tables- Security groups- DHCP options- Private hosted zones (Route53)- OIDC provider- IAM roles and instance profiles- VPC endpoints- Elastic IPs## Quick Cleanup for Orphaned HCsIf a HostedCluster is stuck deleting, you can force remove it:```bash# Remove cleanup annotation to skip cloud resource cleanupKUBECONFIG=$MGMT_KUBECONFIG kubectl annotate hostedcluster <NAME> -n <NAMESPACE> \ hypershift.openshift.io/cleanup-cloud-resources-```## Example Usage```bash# List existing HostedClustersKUBECONFIG=$MGMT_KUBECONFIG kubectl get hostedclusters -A# Destroy a specific HostedClustersource $AWS_CREDS_SOURCE && \KUBECONFIG=$MGMT_KUBECONFIG \./bin/hypershift destroy cluster aws \ --name my-test-cluster \ --namespace clusters \ --aws-creds $AWS_CREDENTIALS \ --region $AWS_REGION```## Troubleshooting### NAT Gateway Still DeletingNAT gateways take time to delete. The command will retry automatically.### VPC Has DependenciesThe command will retry until all dependencies (subnets, gateways, etc.) are deleted.### HostedCluster Stuck in Deleting1. Check if there are stuck finalizers2. Remove the cleanup-cloud-resources annotation if you want to skip AWS cleanup3. Manually delete AWS resources if needed

Frequently asked questions

Destroy HC AWS