Index of every page on this site: llms.txt
All skills
acedergren avatar

/oci-resource-manager

@641a79b
Run it yourself

Use when the user asks to "configure OCI Resource Manager", "debug Resource Manager job", "create ORM stack", "use Resource Manager private endpoint", or "fix Resource Manager dynamic group".

  • 2 files
  • 10.5 KB
  • Updated 6 months ago
  • GitHub
Use this Skill: https://skilld.dev/gh/acedergren/agentic-tools/oci-resource-manager

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈53 tokens for metadata: the name and description. ≈1.2k when used: this file. ≈1.3k more on demand in 1 file.

Description uses 2.7% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈214 characters, or 2.7%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

OCI Resource Manager

Use this skill for OCI Resource Manager stacks, jobs, state, variables, source providers, private endpoints, provider retrieval, drift detection, rollback, import-state jobs, and Resource Manager IAM.

When to Use

Load this skill for: the user asks to "configure OCI Resource Manager", "debug Resource Manager job", "create ORM stack", "use Resource Manager private endpoint", "fix Resource Manager dynamic group", "detect Resource Manager drift", "import Terraform state into Resource Manager", or "connect Resource Manager to Git".

For Terraform language, module, backend, import, or provider questions that are not Resource Manager-specific, also load oci/infrastructure-as-code.

Do NOT load this skill when

Do not load this skill for local Terraform only, OCI service operations that do not involve Resource Manager, or generic CI/CD pipeline work. Use oci/infrastructure-as-code for local Terraform and use the relevant oci/<skill-name> service specialist for networking, IAM, compute, databases, secrets, monitoring, or FinOps.

NEVER Do This

NEVER treat Resource Manager as local Terraform with a UI. Resource Manager stores stack state, runs jobs, locks stack execution, injects stack variables into the Terraform host, retrieves providers, manages source providers, and can use private endpoints.

NEVER upload local Terraform working directories as-is. Do not include .terraform/, .tfstate, .tfplan, local backend credentials, API keys, or private keys in a stack zip or source repository.

NEVER put user credentials or confidential values in Resource Manager Terraform configuration. For Resource Manager, the OCI provider block normally needs only region. Treat stack variables, logs, plans, and state as sensitive surfaces.

NEVER diagnose Resource Manager 403s as Terraform syntax first. Check Resource Manager permissions (orm-stacks, orm-jobs, orm-config-source-providers, orm-private-endpoints) and target OCI service permissions in the target compartments.

NEVER assume private resources are reachable from Resource Manager. Use Resource Manager private endpoints for private Git servers, private instances, private endpoints, or remote-exec flows that need nonpublic network access.

Decision Rules

Resource Manager vs local Terraform

Choose Resource Manager when the user needs centralized OCI-managed state, job history, drift reports, Console/API/CLI job control, source-provider integration, private endpoint access from Oracle-managed execution, or tenancy governance around stack operations.

Choose local Terraform when the user needs local toolchain control, custom wrappers, non-OCI backends, experimental providers not suitable for Resource Manager, or a development loop before handing state to Resource Manager.

Stack configuration

  • Keep provider configuration Resource Manager-friendly: provider "oci" { region = var.region }.
  • Do not add local backend blocks to Resource Manager stacks.
  • Include a schema.yaml only when it improves Console variable entry.
  • Keep module sources supported by Resource Manager and verify source-provider access for private repositories.
  • Pin Terraform and provider constraints in HCL; then review Resource Manager supported versions and provider retrieval behavior.

Jobs and state

  • Run plan before apply unless the workflow explicitly accepts direct apply risk.
  • Remember only one job runs on a stack at a time.
  • Use job logs, detailed logs, state, outputs, and associated resources for diagnosis.
  • Use import-state jobs when migrating local state into Resource Manager.
  • Use rollback jobs when returning to a prior known successful apply is safer than manual repair.

IAM troubleshooting

For users and groups operating Resource Manager, check orm-family or specific orm-* permissions. For resources created by the stack, check the target resource family permissions in the target compartment. For source providers, include read orm-config-source-providers where required. For private endpoints, include orm-private-endpoints and the needed VCN/subnet permissions.

Reference Files

  • Load references/resource-manager-reference.md for current source links, stack/job lifecycle, private endpoints, provider support, source providers, IAM, state migration, and troubleshooting.
  • Load ../infrastructure-as-code/references/oci-terraform-auth-matrix.md when the failure is actually provider auth or principal selection.
  • Load ../infrastructure-as-code/references/oci-terraform-secrets-state.md when stack variables, state, logs, or outputs may contain secret values.

Arguments

$ARGUMENTS: Optional user-provided stack, job, compartment, source provider, private endpoint, Terraform version, symptom, or constraint. When empty, infer the narrowest safe scope from the current repository context and ask only if multiple high-impact choices remain.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 641a79b. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Steadyupdated 6 months ago
version
2.0.0
aliases
[
  "oci-rm",
  "orm",
  "resource-manager"
]
domains
[
  "oci",
  "iac"
]
Other metadata
keywords
[
  "OCI Resource Manager",
  "Resource Manager",
  "ORM",
  "ORM stack",
  "Resource Manager job",
  "private endpoint",
  "source provider",
  "drift detection",
  "Resource Manager dynamic group",
  "import state job",
  "terraform-provider-oci"
]

README badge

README badge for acedergren/agentic-tools/oci-resource-manager