Agent Skills › ruvnet/open-claude-code › occ-diagnose

occ-diagnose

GitHub

诊断 Open Claude Code (OCC) 安装、认证、技能发现及 CLI 故障。适用于 OCC 启动失败、报错或无法找到已安装技能等场景，提供标准化排查步骤与安全修复建议。

skills/occ-diagnose/SKILL.md ruvnet/open-claude-code

Trigger Scenarios

OCC 启动失败返回错误信息无法找到已安装的技能

Install

npx skills add ruvnet/open-claude-code --skill occ-diagnose -g -y

More Options

Use without installing

npx skills use ruvnet/open-claude-code@occ-diagnose

指定 Agent (Claude Code)

npx skills add ruvnet/open-claude-code --skill occ-diagnose -a claude-code -g -y

安装 repo 全部 skill

npx skills add ruvnet/open-claude-code --all -g -y

预览 repo 内 skill

npx skills add ruvnet/open-claude-code --list

SKILL.md

Frontmatter

{
    "name": "occ-diagnose",
    "description": "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."
}

Diagnose Open Claude Code

Capture the failing command, exit status, Node version, and OCC version. Redact credentials and sensitive provider response bodies.
Require Node 20 or newer. Verify npx --yes @ruvnet/open-claude-code@2.1.3 --version and --help before a provider call.
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.
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.
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.
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.
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.