# Oci Functions Troubleshoot

Diagnose OCI Functions setup, control-plane, deployment, invocation, and observability...

- Repository: https://github.com/oracle/skills (909 stars)
- Category: DevOps
- License: UPL-1.0
- Last updated: 2026-10-09
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add oracle/skills --skill oci-functions-troubleshoot -g -a claude-code -y`
Codex: `npx skills add oracle/skills --skill oci-functions-troubleshoot -g -a codex -y`
Cursor: `npx skills add oracle/skills --skill oci-functions-troubleshoot -g -a cursor -y`
Gemini CLI: `npx skills add oracle/skills --skill oci-functions-troubleshoot -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add oracle/skills`

## Description

Diagnose OCI Functions setup, control-plane, deployment, invocation, and observability issues using a deterministic triage workflow. Use when asked to classify Fn CLI errors, deploy or invoke failures, OCIR auth and registry issues, app-limit symptoms, logs, tracing, metrics, or limits. Diagnose first, prefer read-only checks, and do not execute fixes unless the user explicitly asks.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# OCI Function Troubleshoot

Use this skill to isolate the most likely cause of an OCI Functions problem from error text, command output, or observability signals.

This skill is diagnosis-first and non-mutating by default:
- prefer read-only checks
- do not edit Fn context, log into Docker, create or update apps, redeploy, or change infrastructure unless the user explicitly asks to execute a fix
- if the user wants the fix executed, finish the diagnosis first and hand off mutating remediation to `$oci-functions-deploy`

## Output Contract

Always answer in this exact shape:
- `stage`: one of `setup_or_control_plane`, `create`, `deploy`, `invoke`, `observability_first`
- `evidence`: 1-3 concrete facts from the user's error text, command, config, logs, metrics, or limits
- `most_likely_cause`: one primary cause, or a ranked top-2 shortlist when confidence is low
- `confidence`: `low`, `medium`, or `high`
- `next_confirming_check`: the single best read-only check to narrow or confirm the cause
- `smallest_safe_remediation`: the least invasive next action; if evidence is weak, this can be "collect more evidence with ..."
- `validation`: the follow-up step that proves the remediation worked

## Triage

The rest: https://github.com/oracle/skills/blob/HEAD/oci/functions/oci-functions-troubleshoot/SKILL.md