Agent skill · data analytics · jeremylongshore
oraclecloud-common-errors
Diagnose and fix Oracle Cloud Infrastructure API errors with real error
Why this skill is useful
Provides specific diagnostic scripts and error resolution patterns for Oracle Cloud Infrastructure API errors that the AI wouldn't reliably generate on its own.
What it needs
Requires python installed locally. Requires oraclecloud account access. About 6k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Oracle Cloud Common Errors Overview OCI API errors are notoriously cryptic. NotAuthorizedOrNotFound (404) could mean an IAM policy is missing or you typed the OCID wrong — the error is intentionally ambiguous for security. NotAuthenticated (401) covers six different config file problems. CERTIFICATEVERIFYFAILED has different fixes depending on your SDK language, OS, and whether you are behind a corporate proxy. Purpose: A diagnostic decoder ring mapping every common OCI error to its real root cause and fix, with runnable diagnostic commands for each scenario. Prerequisites An OCI account with ~/.oci/config configured (see oraclecloud-install-auth) Python 3.8+ with pip install oci installed OCI CLI installed (pip install oci-cli) for diagnostic commands Instructions Authentication Errors (401 NotAuthenticated) The 401 error has six distinct root causes. Run this diagnostic to isolate which one: 401 Root Cause Table: Symptom Root Cause Fix --------- ----------- ----- did not find a proper configuration for user Missing or malformed ~/.oci/config Recreate with oci setup config could not find private key keyfile path wrong or file missing Check path; key must exist at that location private key does not match Fingerprint in config does not match uploaded public key Upload correct public key or regenerate pair keyfile points to public key keyfile=~/.oci/ociapikeypublic.pem Change to keyfile=~/.oci/ociapikey.pem (private key) permission denied reading key Key file permissions too open chmod 600 ~/.oci/ociapikey.pem InvalidKeyId User OCID or tenancy OCID wrong Verify OCIDs in Console > Profile > User Settings Authorization Errors (404 NotAuthorizedOrNotFound) This is the most confusing OCI error. A 404 means either the resource does not exist or you lack IAM permission to see it. OCI hides the distinction intentionally. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/oraclecloud-common-errors