oci

Name: oci
Author: evolv3-ai

github.com/evolv3-aiCloud & DevOps140 installsUpdated 14w ago

About oci

A deployment skill for OCI users that guides CLI setup, ARM capacity checks, and infrastructure provisioning or cleanup. It requires deployment parameters to be confirmed first and includes scripts for capacity monitoring and automated deployment.

Key features

01Pre-deployment parameter checklist
02Check ARM instance capacity
03Monitor capacity and deploy automatically
04Create networking and compute resources
05Clean up compartment resources

Use cases

01Confirm OCI deployment settings
02Find available ARM instance capacity
03Deploy when capacity becomes available
04Delete a compartment and its resources

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/evolv3-ai/vibe-skills --skill oci

After installing, type/ociin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

assets/

env-template

references/

CAPACITY.md

CONFIG.md

INSTALL.md

NETWORKING.md

OPERATIONS.md

TROUBLESHOOTING.md

scripts/

.env.example

check-oci-capacity.sh

cleanup-compartment.sh

monitor-and-deploy.sh

oci-infrastructure-setup.sh

Details

From the project README

Oracle Cloud Infrastructure (OCI)

CRITICAL: Secrets and .env

NEVER store live .env files or credentials inside any skill folder.
.env.template files belong only in assets/ within a skill.
Store live secrets in ~/.admin/.env and reference from there.

Status: Production Ready | Dependencies: OCI CLI, SSH key pair

Navigation

Operations, troubleshooting, config, and cleanup: references/OPERATIONS.md
CLI install/config/capacity/networking details: references/

Step 0: Gather Required Information (MANDATORY)

STOP. Before ANY deployment commands, collect ALL parameters from the user.

Copy this checklist and confirm each item:

Required Parameters:
- [ ] SERVER_NAME       - Unique name for this server
- [ ] OCI_REGION        - Region (us-ashburn-1, us-phoenix-1, ca-toronto-1, etc.)
- [ ] OCI_SHAPE         - Instance shape (see profiles below)
- [ ] OCI_OCPUS         - Number of OCPUs (1-4 for Always Free)
- [ ] OCI_MEMORY_GB     - Memory in GB (1-24 for Always Free)
- [ ] SSH_KEY_PATH      - Path to SSH public key (default: ~/.ssh/id_rsa.pub)

Deployment Purpose (determines recommended profile):
- [ ] Purpose: coolify / kasm / both / custom
      coolify → 2 OCPU, 12GB RAM (Always Free eligible)
      kasm    → 4 OCPU, 24GB RAM (Always Free eligible)
      both    → 4 OCPU, 24GB RAM (Always Free eligible)

Always Free Tier Limits:
- Shape: VM.Standard.A1.Flex (ARM64)
- Max: 4 OCPUs, 24GB RAM total (can split across instances)

Recommended profiles by purpose:

Purpose	OCPUs	RAM	Shape	Cost
coolify	2	12GB	VM.Standard.A1.Flex	FREE
kasm	4	24GB	VM.Standard.A1.Flex	FREE
both	4	24GB	VM.Standard.A1.Flex	FREE

DO NOT proceed to Prerequisites until ALL parameters are confirmed.

Prerequisites

Before using this skill, verify the following:

1. OCI CLI Installed

oci --version

If missing, install with:

bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)" -- --accept-all-defaults
source ~/.bashrc  # or restart terminal

2. OCI CLI Configured

ls ~/.oci/config

If missing, configure with:

oci setup config

You'll need:

Tenancy OCID (OCI Console → Profile → Tenancy)
User OCID (OCI Console → Profile → My Profile)
Region (e.g., us-ashburn-1)
API key pair (wizard generates this)

3. SSH Key Pair

ls ~/.ssh/id_rsa.pub

If missing, generate with:

ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa -N ""

4. SSH Key Permissions

stat -c %a ~/.ssh/id_rsa  # Should be 600

If wrong, fix with:

chmod 600 ~/.ssh/id_rsa

5. Test Authentication

oci iam availability-domain list

If this fails: API key may not be uploaded to OCI Console → Profile → API Keys

Script path resolution: When Claude Code loads this file, it provides the full path. All scripts/ references below are relative to this file's directory. Derive SKILL_DIR from this file's path and prepend it when running scripts.

Quick Start

1. Check Capacity First

OCI Always Free ARM instances are highly demanded. Always check before deploying:

scripts/check-oci-capacity.sh

Options and troubleshooting

# Check specific region
scripts/check-oci-capacity.sh us-ashburn-1

# Use different OCI profile
scripts/check-oci-capacity.sh --profile PRODUCTION

# Check multiple regions
for region in us-ashburn-1 us-phoenix-1 ca-toronto-1; do
  echo "=== $region ==="
  scripts/check-oci-capacity.sh "$region"
done

No capacity? Use automated monitoring:

scripts/monitor-and-deploy.sh --stack-id <STACK_OCID>

2. Deploy Infrastructure

# Configure environment
cp scripts/.env.example scripts/.env
# Edit scripts/.env with your values

# Deploy
scripts/oci-infrastructure-setup.sh

Scripts Reference

Script	Purpose	Usage
`check-oci-capacity.sh`	Check ARM instance availability	`scripts/check-oci-capacity.sh [region]`
`oci-infrastructure-setup.sh`	Full infrastructure deployment	`scripts/oci-infrastructure-setup.sh`
`monitor-and-deploy.sh`	Auto-deploy when capacity available	`scripts/monitor-and-deploy.sh --stack-id <ID>`
`cleanup-compartment.sh`	Delete all resources	`scripts/cleanup-compartment.sh <COMPARTMENT_OCID>`

Script details

check-oci-capacity.sh

Checks VM.Standard.A1.Flex availability across availability domains.

scripts/check-oci-capacity.sh                    # Home region
scripts/check-oci-capacity.sh us-ashburn-1       # Specific region
scripts/check-oci-capacity.sh --profile DANIEL   # With profile

Tests 4 OCPU / 24GB RAM (full free tier), falls back to 2/12 if unavailable.

monitor-and-deploy.sh

Continuously monitors and auto-deploys when capacity found.

scripts/monitor-and-deploy.sh \
  --stack-id <STACK_OCID> \
  --profile DANIEL \
  --interval 300 \
  --max-attempts 100

oci-infrastructure-setup.sh

Creates complete infrastructure: compartment → VCN → subnet → IGW → security list → instance.

Requires .env file with OCI credentials and configuration.

cleanup-compartment.sh

Safely deletes compartment and all resources (requires confirmation).

scripts/cleanup-compartment.sh ocid1.compartment.oc1..xxx

Operations

Common issues, best practices, configuration variables, and cleanup ordering are in references/OPERATIONS.md.

Logging Integration

When performing infrastructure operations, log to the centralized system:

# After provisioning
log_admin "SUCCESS" "operation" "Provisioned OCI instance" "id=$INSTANCE_ID provider=OCI"

# After destroying
log_admin "SUCCESS" "operation" "Terminated OCI instance" "id=$INSTANCE_ID"

# On error
log_admin "ERROR" "operation" "OCI deployment failed" "error=OUT_OF_HOST_CAPACITY"

See admin skill's references/logging.md for full logging documentation.

Additional Documentation

Installation Guide - Install OCI CLI on any OS
Configuration Guide - Set up OCI credentials
Capacity Guide - Handling capacity issues
Networking Guide - VCN, subnets, security lists
Troubleshooting Guide - Common issues and solutions

Official Resources

Comments

Markdown supported

Details

Author: evolv3-ai
Repository: evolv3-ai/vibe-skills
Category: Cloud & DevOps
Installs: 40
GitHub stars: 1

Report

More skills

All skills

lark-apps

open.feishu.cn

746.5k

Develop and host Miaoda (Spark/Miaoda) apps: app creation, local full-stack development, cloud generation and iteration, creative design (UI mockups / interactive prototypes / wireframes / landing pages / dashboards / slide decks / visual exploration), integration of AI-related capabilities, Feishu platform capabilities, or other external capabilities; log/Trace/monitoring metric/PV/UV queries; environment variable management; app collaborators and collaboration permissions; app roles and members; and automation triggers (scheduled / record changes / Webhook / Feishu approvals). Use when users want to develop or create a system, tool, platform, or app; develop locally or in the cloud, modify, deploy, publish, launch, or get a shareable link; create a page or website with HTML and deploy it to Miaoda; design, create a mockup, prototype, wireframe, PPT, deck, or visual exploration; or mention Miaoda/Spark/Miaoda apps (links like `/app/app_xxx` or `/page/<token>`, runtime domains like *.aiforce.cloud), app databases, app file storage, open API Keys, visibility, app collaborators/developer permissions, app roles/role members, production logs, API request volume, error volume, latency, traffic, environment variables, or setting up automation tasks, scheduled triggers, or approval-triggered automation for Miaoda apps. Not for regular cloud drive file uploads (lark-drive), Feishu document editing (lark-doc), or native slide creation (lark-slides).

wizard

github.com/mattpocock

583.8k

Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.

azure-prepare

github.com/microsoft

575.1k

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

azure-ai

github.com/microsoft

574.4k

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.