Agent skill · software engineering · jeremylongshore
oraclecloud-hello-world
Launch your first OCI compute instance with capacity retry logic.
Why this skill is useful
Adds a complete executable script for launching OCI compute instances with capacity retry logic, which is not commonly found in public documentation.
What it needs
Requires python installed locally. Requires oraclecloud account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Oracle Cloud Hello World Overview Launch, list, and manage your first OCI compute instance. The most common blocker for new OCI users is the Out of host capacity error when launching Always Free ARM shapes (VM.Standard.A1.Flex). This error means the data center has no available hosts — it is not a permissions issue. The solution is a retry loop that polls until capacity becomes available. Purpose: Get a running compute instance on OCI, including the capacity retry pattern that makes Always Free ARM shapes actually usable. Prerequisites Completed oraclecloud-install-auth — valid ~/.oci/config with API key authentication Python 3.8+ with pip install oci installed A subnet OCID in your tenancy (VCN > Subnets in the Console, or use the default VCN) An image OCID for your region (Compute > Custom Images, or list platform images via API) An SSH public key at ~/.ssh/idrsa.pub (for instance access) Instructions Step 1: List Existing Instances Step 2: List Available Shapes and Images Step 3: Launch an Instance (Standard) Step 4: Wait for Instance to Be Running Step 5: Launch with Capacity Retry (Always Free ARM) This is the pattern you need for VM.Standard.A1.Flex shapes. OCI returns Out of host capacity intermittently — retry until a host becomes available: Step 6: Instance Lifecycle Operations Step 7: OCI CLI Equivalent Output Successful completion produces: A list of existing compute instances in your tenancy A newly launched compute instance (standard or ARM Always Free) in RUNNING state The instance OCID for use in subsequent lifecycle operations SSH connectivity to the instance via its public IP Error Handling Error Code Cause Solution ------- ------ ------- ---------- Out of host capacity 500 No ARM hosts available in the AD Use the retry loop in Step 5; try a different AD or region NotAuthenticated 401 Invalid config or key mismatch Run oraclecloud-install-auth to fix config NotAuthorizedOrNotFound 404 Wrong compartment OCID or missing IAM policy Verify compartment O …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/oraclecloud-hello-world