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

/infrastructure-as-code

@641a79b
Run it yourself

Use when the user asks to "Terraform state on OCI", "native OCI backend", "Terraform import OCI", "Terraform apply 403", "Terraform ZPR", or "Terraform Bastion".

Use this Skill: https://skilld.dev/gh/acedergren/agentic-tools/infrastructure-as-code

Nothing lands on disk. Nothing to clean up.

Fork this Skill

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

SKILL.md

≈46 tokens for metadata: the name and description. ≈1.8k when used: this file. ≈6.2k more on demand in 9 files.

Description uses 2.3% 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 ≈186 characters, or 2.3%.

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 Terraform Hub

Use this skill as the canonical router for Terraform and OpenTofu-style OCI infrastructure work. Keep high-drift provider, backend, region, and cost facts in references and verify official docs before giving current claims.

When to Use

Load this skill for: the user asks to "Terraform state on OCI", "native OCI backend", "debug terraform-provider-oci", "Terraform import OCI", "OCI Terraform auth", "OCI module quality", "government cloud Terraform", "Terraform apply 403", or "build OCI IaC".

Also load it when Terraform touches an OCI sibling domain, then load the sibling skill only for that domain detail:

Terraform task Also load
Resource Manager stack, job, source provider, or private endpoint oci/oci-resource-manager
ZPR policy, security attributes, or protected resources oci/zpr-security
Bastion, Managed SSH, port forwarding, or allowlists oci/managed-bastion-access
VCN, subnet, route table, DRG, Service Gateway, NAT Gateway oci/networking-management
IAM policy, identity domain, dynamic group, 403/404 oci/iam-identity-management
Vault secret, wallet, password, private key, sensitive output oci/secrets-management
Capacity, quota, shape, boot volume, instance principal oci/compute-management
Estimate, budget, Resource Scheduler, egress, quota cost oci/finops-cost-optimization

Do NOT load this skill when

Do not load this skill for unrelated general programming, non-Oracle cloud work, or pure Oracle service operations without Terraform. Use oci for OCI skill-pack routing and oci/best-practices for broad OCI architecture triage.

NEVER Do This

NEVER default new Terraform state on OCI to S3-compatible Object Storage. For Terraform v1.12 and later, prefer the native backend "oci" with Object Storage, state locking, and bucket versioning. Use S3-compatible Object Storage only as a legacy fallback when the target Terraform runtime cannot use the native OCI backend.

NEVER put credentials, generated passwords, wallets, or private keys in durable state by accident. sensitive = true redacts CLI/UI output but does not remove values from state or plan files. Prefer passing secret OCIDs, letting workloads retrieve secrets at runtime, and using Terraform ephemeral or write-only features only when the Terraform version and OCI provider/resource support them.

NEVER treat Resource Manager as just "Terraform in the console." Resource Manager owns stack state, job execution, variables, provider retrieval, source providers, private endpoints, and IAM behavior. Route those cases to oci/oci-resource-manager.

NEVER diagnose Terraform apply gets 403 before identifying the caller. Decide whether the caller is a local API key user, session-token profile, CI principal, instance principal, resource principal, Resource Manager job/user, or OKE workload identity. Then check policy location, principal type, verb, resource family, and compartment scope.

NEVER trust an Oracle-branded Terraform module just because it is official. Check release recency, provider constraints, issue activity, examples, supported resources, sensitive outputs, generated plan shape, and upgrade path before recommending any module.

NEVER automate ZPR or Bastion as a shortcut around rollout safety. ZPR can block traffic when attributes are applied before policy, and Bastion Terraform can widen client allowlists or leak keys into state. Load the focused references before writing HCL.

NEVER hardcode tenancy-specific values unless the deployment contract requires it. Avoid hardcoded availability-domain names, compartment OCIDs, subnet IDs, region domains, and provider endpoints. Query or inject them as variables/data sources and document the owning tenancy boundary.

Decision Rules

State backend

  1. Terraform v1.12+ and normal team collaboration: use native backend "oci".
  2. Resource Manager stack: let Resource Manager manage state; do not force a local backend into the stack.
  3. Terraform older than v1.12 or constrained runtime: use S3-compatible Object Storage only as a documented legacy fallback.
  4. Local state: use only for disposable experiments; never for team or production state.

Auth

Choose auth by execution context, not habit:

Context Default direction
Local laptop API key profile or short-lived security token profile
GitHub Actions / external CI Approved federation/OIDC if configured; otherwise tightly scoped API key secret
OCI DevOps Service/resource principal with dynamic group policies
Resource Manager Region-only provider block; stack/user/job IAM handled by Resource Manager
Compute instance auth = "InstancePrincipal" with matching dynamic group and policies
Function or supported OCI service auth = "ResourcePrincipal"
OKE workload auth = "OKEWorkloadIdentity" when supported

Adoption and drift

Prefer provider pinning, terraform import, import blocks, moved blocks, lifecycle review, and official import IDs. Treat delete/recreate as a last resort after confirming data-loss, replacement, and downtime risk.

Realms and regions

Verify region identifier, realm domain, service availability, Resource Manager availability, FIPS requirements, and dedicated endpoint settings before writing Terraform for government, defense, dedicated, or sovereign environments.

Reference Loading

Load only the narrow reference needed for the task:

Arguments

$ARGUMENTS: Optional user-provided target, path, environment, symptom, Terraform version, execution context, 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 alerts7mo4 checks · Risk SAFE
  • Gen Agent Trust Hub8mo

    The skill provides technical guidance and HCL code snippets for managing Oracle Cloud Infrastructure (OCI) using Terraform. It covers best practices for resource lifecycle management, authentication methods, and state file recovery while referencing official OCI modules.

  • Socket8mo

    No alerts

  • Snyk8mo

    Risk: LOW · No issues

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

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-terraform",
  "oci-iac",
  "terraform-oci"
]
domains
[
  "oci",
  "iac"
]
Other metadata
keywords
[
  "OCI",
  "Oracle Cloud",
  "Terraform",
  "terraform-provider-oci",
  "native OCI backend",
  "Terraform state",
  "Resource Manager",
  "Terraform import",
  "moved block",
  "provider pinning",
  "government cloud Terraform",
  "OCI Terraform auth",
  "OCI module quality",
  "Terraform ZPR",
  "Terraform Bastion"
]

README badge

README badge for acedergren/agentic-tools/infrastructure-as-code