Official agent skill

Oci Functions Troubleshoot

by oracle in oracle/skills

Diagnose OCI Functions setup, control-plane, deployment, invocation, and observability issues using a deterministic triage workflow.

OfficialUPL-1.0Auto-check passedDevOps & Cloud

Install Oci Functions Troubleshoot

skills CLI
$ npx skills add oracle/skills --skill oci-functions-troubleshoot -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install oracle/skills oci-functions-troubleshoot --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/oracle/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/oci/functions/oci-functions-troubleshoot .claude/skills/oci-functions-troubleshoot && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
oci-functions-troubleshoot
GitHub stars
877
Token cost
~2.3k tokens
SKILL.md length
1,078 words
Files
9 (incl. references)
Skills in repo
15
Repo updated
First seen
Licence
UPL-1.0

At a glance

Diagnose OCI Functions setup, control-plane, deployment, invocation, and observability issues using a deterministic triage workflow.

  • Works in 2 steps: If the user provides an exact error… → Classify the issue from the failed action
  • Asked to classify Fn CLI errors
  • SKILL.md covers Output Contract, Triage, Minimum Facts and Preferred Read-Only Checks, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Oci Functions Troubleshoot is an agent skill from oracle/skills, published by the product's own GitHub organization. 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.

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including reference files (for example `agents/openai.yaml`, `references/create.md` and `references/deploy.md`).

It sits in DevOps & Cloud, covering Observability and Deployment. The repository describes itself as: Oracle Skills is a curated, open-source collection of practical, installable skills for working with Oracle technologies. It provides developers, administrators, and AI agents…

When your agent uses it

  • Asked to classify Fn CLI errors
  • Invoke failures
  • OCIR auth and registry issues
  • App-limit symptoms

Example prompts

  • “/oci-functions-troubleshoot”

Requirements

  • Docker

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. If the user provides an exact error string, start with references/error-patterns.md.
  2. Classify the issue from the failed action

What it can do on your machine

Read from SKILL.md and the folder at commit 014cdb2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.oracle.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Oci Functions Troubleshoot loads about 2.3k tokens when it runs, and up to ~8.2k if it reads all its reference files. Until then it costs about 103 tokens; SKILL.md has 1,078 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~103
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (UPL-1.0) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,078 words (~2,326 tokens).

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

— opening of SKILL.md by oracle, UPL-1.0
name
oci-functions-troubleshoot

Read the full SKILL.md on GitHub

Files

SKILL.md and 8 other files (references) in oci/functions/oci-functions-troubleshoot of oracle/skills.

  • SKILL.md
  • agents/openai.yaml
  • references/create.md
  • references/deploy.md
  • references/error-patterns.md
  • references/example-prompts.md
  • references/invoke.md
  • references/observability.md
  • references/setup-and-runtime.md

Open the folder on GitHubat commit 014cdb2

Compare with similar skills

Oci Functions Troubleshoot next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Oci Functions Troubleshoot compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Oci Functions Troubleshoot this skilloracle/skills877—~2.3kAutomated safety check: PassUPL-1.0
Kubeshark Installerkubeshark/kubeshark12k—~3.6kAutomated safety check: NotesApache-2.0
KubeSphere ServiceMesh Managerkubesphere/kubesphere17k—~2.4kAutomated safety check: PassCustom licence
Google Agents CLI Observabilitypifferologo/cloud-agents-cli1291 repos~2.5kAutomated safety check: PassApache-2.0
Deploy Observabilityaliyun/alibabacloud-observability-mcp-server166—~2.6kAutomated safety check: NotesNone
Temps Best Practicesgotempsh/temps831—~2.9kAutomated safety check: PassApache-2.0

Similar skills

  • Kubeshark Installer

    kubeshark/kubeshark

    Installs and configures Kubeshark on a Kubernetes cluster, choosing between the quick CLI path and a Helm install with custom values.

    12k GitHub stars~3.6k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • KubeSphere ServiceMesh Manager

    kubesphere/kubesphere

    Installs, checks and troubleshoots the KubeSphere ServiceMesh extension (Istio, Kiali, Jaeger), including grayscale release, sidecar injection, topology and tracing issues.

    17k GitHub stars~2.4k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Google Agents CLI Observability

    pifferologo/cloud-agents-cli

    This skill should be used when the user wants to "set up tracing", "monitor my ADK agent", "configure logging", "add observability", "debug production traffic", or needs guidance on monitoring…

    129 GitHub starsUsed in 1 repo~2.5k tokens
    DevOps & CloudAuto-check passed
  • Deploy Observability

    aliyun/alibabacloud-observability-mcp-server

    Deploy, start, and update the Alibaba Cloud Observability MCP Server (阿里云可观测 MCP Server).

    166 GitHub stars~2.6k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check: notes
  • Temps Best Practices

    gotempsh/temps

    Best-practices reference for preparing and instrumenting applications on Temps.

    831 GitHub stars~2.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Temps CLI

    gotempsh/temps

    Operate Temps through the pinned @temps-sdk/cli package with bunx or npx.

    831 GitHub stars~2k tokensUpdated today
    DevOps & CloudAuto-check passed

More from oracle/skills

All 15 skills in this repo
  • Official

    Deploy and troubleshoot multihome networking on OCI Kubernetes Engine using existing GVA secondary VNIC node pools, Multus thick plugin, OCI CNI/IPAM, NetworkAttachmentDefinitions, and test pods.

    877 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Official

    Build, configure, scaffold, and deploy OCI Functions from a local machine using a dependency-first, Fn-context-guided flow with argv-safe mutation execution, nonce-scoped confirmations, and a…

    877 GitHub stars~4.6k tokensUpdated yesterday
    Auto-check passed
  • Oci Iot Platform

    oracle/skills

    Official

    Explore, create, and troubleshoot Oracle Cloud Infrastructure Internet of Things Platform resources, including domains, digital twin models, adapters, instances, relationships, and device publish…

    877 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • DB

    oracle/skills

    Official

    Oracle Database guidance for SQL, PL/SQL, SQLcl, ORDS, Oracle Vector SDK, administration, app development, performance, security, migrations, and agent-safe database workflows.

    877 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Enterprise AI

    oracle/skills

    Official

    Oracle Enterprise AI guidance for building, deploying, securing, estimating cost for, and integrating AI models, agents, RAG, Responses API workflows, custom or imported models, fine-tuning, model…

    877 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Oke Gva Deployer

    oracle/skills

    Official

    A skill your agent uses when the user asks to enable, deploy, or configure Generic VNIC Attachment (GVA) for OCI Kubernetes Engine (OKE), create node pools with secondary VNIC profiles, review…

    877 GitHub stars~3.6k tokensUpdated yesterday
    Auto-check: warnings

Categories

Questions about Oci Functions Troubleshoot

What does Oci Functions Troubleshoot do?

Diagnose OCI Functions setup, control-plane, deployment, invocation, and observability issues using a deterministic triage workflow. Oci Functions Troubleshoot is an agent skill from oracle/skills, published by the product's own GitHub organization. Diagnose OCI Functions setup, control-plane, deployment, invocation, and observability issues using a deterministic triage workflow.

When should I use Oci Functions Troubleshoot?

Oci Functions Troubleshoot fits situations like: asked to classify Fn CLI errors; invoke failures; OCIR auth and registry issues; app-limit symptoms.

How do I install Oci Functions Troubleshoot in Claude Code?

Run `npx skills add oracle/skills --skill oci-functions-troubleshoot -a claude-code`. Or copy the skill folder (oci/functions/oci-functions-troubleshoot in oracle/skills) into .claude/skills/oci-functions-troubleshoot in your project. Claude Code loads it when a task matches its description.

How do I install Oci Functions Troubleshoot in Codex?

Run `npx skills add oracle/skills --skill oci-functions-troubleshoot -a codex`. Or copy the skill folder (oci/functions/oci-functions-troubleshoot in oracle/skills) into .agents/skills/oci-functions-troubleshoot in your project. Codex loads it when a task matches its description.

Can I use Oci Functions Troubleshoot in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add oracle/skills --skill oci-functions-troubleshoot -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/oci-functions-troubleshoot, .gemini/skills/oci-functions-troubleshoot, .github/skills/oci-functions-troubleshoot and .opencode/skills/oci-functions-troubleshoot in your project.

What does Oci Functions Troubleshoot need to run?

SKILL.md names no scripts, command-line tools or credentials: Oci Functions Troubleshoot is instructions for the agent only. Our summary lists: Docker.

Does Oci Functions Troubleshoot access the network?

SKILL.md names 1 domain. As links in the text: docs.oracle.com. This is read from the text; nothing was executed.

Is Oci Functions Troubleshoot safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Oci Functions Troubleshoot use?

Oci Functions Troubleshoot is published under the UPL-1.0 licence (the repository's licence).

How many tokens does Oci Functions Troubleshoot use?

About 2.3k tokens (SKILL.md is roughly 9.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.9k tokens, read only when the agent opens those files.

What are the alternatives to Oci Functions Troubleshoot?

Skills that share tags, products or a category with Oci Functions Troubleshoot: Kubeshark Installer (kubeshark/kubeshark, 12k stars), KubeSphere ServiceMesh Manager (kubesphere/kubesphere, 17k stars), Google Agents CLI Observability (pifferologo/cloud-agents-cli, 129 stars) and Deploy Observability (aliyun/alibabacloud-observability-mcp-server, 166 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Oci Functions Troubleshoot?

oracle (a GitHub organization, an official publisher) maintains it in oracle/skills, which has 877 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 9, 2026.

Source: oracle/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.