Skip to content
cccskills
FreePublished on GitHub

occ-diagnose

Diagnose Open Claude Code installation, provider authentication, skill discovery, and CLI failures. Use when OCC fails to start, returns errors, or cannot find an installed skill.

The English summary is being prepared. Showing the original description.

ruvnet/open-claude-code
Works withOpenAI
See how to install

Files included (1)

  • SKILL.md1.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

occ-use

Free

Run Open Claude Code (OCC) for coding tasks and verify its CLI installation. Use when asked to use OCC, select its provider, or perform a bounded coding task through its CLI.

The English summary is being prepared. Showing the original description.

ruvnet/open-claude-code537Updated Oct 19, 2026

occ-verify-release

Free

Verify Open Claude Code package integrity, release tests, and automation evidence. Use when asked whether an OCC release is published, tested, or fully automated.

The English summary is being prepared. Showing the original description.

ruvnet/open-claude-code537Updated Oct 19, 2026

See all skills by ruvnet

Report a problem with this skill