SuperAPI AI Directory

occ-diagnose

Coding & development

View repository

Updated 10-16 08:37

About this skill

Diagnose Open Claude Code
  1. Capture the failing command, exit status, Node version, and OCC version. Redact credentials and sensitive provider response bodies.
  2. Require Node 20 or newer. Verify npx --yes @ruvnet/open-claude-code@2.1.3 --version and --help before a provider call.
  3. For authentication failures, check only whether the required environment variable is present. Never print its value. Match ANTHROPIC_API_KEY to Anthropic or OPENAI_API_KEY to an OpenAI compatible endpoint. Routing depends on the model name: use --model gpt-4.1-mini for an OpenAI compatible route. Check base URL and model selection without exposing credentials.
  4. For a newly published npm version returning ETARGET or E404, retry metadata/install with a fresh cache and prefer-online for at most five minutes. Do not treat authentication, integrity, or behavioral failures as propagation delays.
  5. For missing skills, inspect project .claude/skills/<name>/SKILL.md and user ~/.claude/skills/<name>/SKILL.md. OCC 2.1.2 follows directory symlinks; project skills override user skills. A broken symlink is ignored.
  6. Claude Code plugins and OCC's custom PluginLoader are different contracts. This repository's native plugin supplies skills to Claude Code; it does not make OCC support every third party Claude plugin.
  7. Reproduce with the smallest allowed tool set, retain sanitized evidence, and propose a targeted fix. Do not delete user configuration or rotate secrets without authorization.