arkcli-doctor

A diagnostic tool for ARK services, accounts, models, and inference endpoints. An inference endpoint is the online address through which an AI model receives requests.

In plain words
What is it for?
Use it to check command-line health, account setup, a model, an endpoint's status and error rate, quotas, or the meaning of an error code.
Why use it?
It turns vague errors or resource problems into checks and suggested fixes, while its diagnostic commands are read-only by default.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/volcengine/ark-cli/arkcli-doctor
Any agent
npx skills add volcengine/ark-cli --skill arkcli-doctor
Clone the repo
git clone --depth 1 https://github.com/volcengine/ark-cli

Made for: Claude Code, Codex.

Per session 208 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 6,376 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00208 $0.06376
Opus 5 $0.00104 $0.03188
Sonnet 5 $0.00042 $0.01275
Haiku 4.5 $0.00021 $0.00638

Measured 2d ago against content hash f75fe6a13b22, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

arkcli-doctor scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/arkcli-doctor/SKILL.md · 281 lines

How it starts

The opening of the file, as written. The whole thing — 281 lines — stays where its author put it; the contents beside it link to each section on GitHub.

arkcli Doctor(诊断总入口)

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../arkcli-shared/SKILL.md(认证闸门、命令选择顺序、输出与安全规则)。

它解决什么

arkcli doctor 是 Ark CLI 唯一的对外诊断收口。所有诊断与修复建议都从 arkcli doctor [<scope>] [<id>] 出,诊断命令默认只读;修复动作按命令输出的建议和对应 reference 执行。Agent 拿到用户的报错 / 资源 ID / 含糊问题后,先用本 skill 决定走哪条路径,再 delegate 到对应 scope reference 或错误码 reference。

边界:安装、版本、登录、profile、AK/SK 认证类问题归 arkcli-shared / arkcli-auth;这里只覆盖 arkcli doctor 命令家族(业务侧诊断)。

八个 Domain(一个 skill 收口)

本 skill 一次性覆盖八个平行 domain。每个 domain 一份 reference,按用户场景路由:

Domain 命令 Reference 解决什么
CLI 健康(默认) arkcli doctor references/scope-cli.md 本地二进制版本 / 网络联通 / 时钟偏差 / 当前 profile 认证——onboarding 首查
account arkcli doctor account references/scope-account.md identity / realname / balance / IAM Ark 系统预置策略 / VMP 三段 / TOS 开通
错误码 arkcli doctor error <code> references/error-codes.md 单错误码翻译成结构化诊断 + 修复(含生视频 5 个 subtype + 通用 Ark/公共码)
infer-endpoint arkcli doctor infer-endpoint <id> references/scope-infer-endpoint.md 单接入点状态 / 用量 / 错误率 / 配额压力
model arkcli doctor model <name> references/scope-model.md 跨接入点的模型整体诊断(用量 / 配额 / top endpoint / 模态自适应指标)
metrics arkcli doctor metrics <id> references/scope-metrics.md 36 条具名 PromQL 查询(指标值直出,不打健康判定,给 LLM/SRE 拿数)
report arkcli doctor report references/scope-report.md seedance 2.x 效果问题上报(badcase → 方舟排障平台)
verify-origin arkcli doctor +verify-origin ... references/verify-origin.md 对 1-20 个图片/视频 URL 创建来源特征验证任务并轮询官方结果

Read the full file on GitHub · 281 lines

Files

What ships with it

10 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 281 lines · 208 tokens per session scan A f75fe6a13b22

Subscribe to this mod's changes

arkcli-doctor is a skill published in the GitHub repository volcengine/ark-cli (112 stars, last pushed 5d ago), licensed Apache-2.0. It adds 208 tokens to every session and 6,376 once invoked, about $0.0010 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

happiness-skill

当用户问「怎么才能更幸福/为什么得到了还不满足/怎么减少焦虑」时调用。 核心理念: 幸福是缺憾感清空的默认状态, 是可训练的技能; 欲望是与自己的契约(得到前不快乐), 同时只留一个重大欲望; 活在当下。 不适用于: 临床抑郁等需要专业治疗的场景(本书方法不能替代医疗)。 Triggers: 幸福/不快乐/欲望/焦虑/知足/活在当下/happiness/desire/anxiety.

kangarooking/cangjie-skill · 136 tokens

ddia-systems

Design data systems by understanding storage engines, replication, partitioning, transactions, and consistency models. Use when the user mentions "database choice", "which database should I use", "SQL or NoSQL", "replication lag", "partitioning strategy", "consistency vs availability", "stream processing", "ACID…

wondelai/skills · 138 tokens

improve-website

Guided journey from a live website that underperforms to a prioritized, evidence-backed backlog of conversion, usability, message, and speed fixes - each shipped as a testable experiment. Orchestrates eight skills phase by phase - cro-methodology, ux-heuristics, refactoring-ui, web-typography, storybrand-messaging…

wondelai/skills · 225 tokens

ios-hig-design

Design native iOS interfaces following Apple Human Interface Guidelines. Use when the user mentions "iPhone app", "iPad layout", "SwiftUI", "UIKit", "Dynamic Island", "safe areas", "HIG compliance", "SF Symbols", "haptic feedback", "iOS accessibility", "make my app feel native", or "follow Apple design guidelines".…

wondelai/skills · 145 tokens

jobs-to-be-done

Discover what customers truly need by analyzing the "job" they hire your product to do. Use when the user mentions "customer discovery", "why customers churn", "what job does this solve", "competing against luck", "product-market fit", "switching behavior", "milkshake moment", or "functional vs emotional jobs". Also…

wondelai/skills · 137 tokens

lean-startup

Design MVPs, validated learning experiments, and pivot-or-persevere decisions using Build-Measure-Learn. Use when the user mentions "MVP scope", "validated learning", "pivot or persevere", "vanity metrics", "test assumptions", "innovation accounting", "build-measure-learn", "minimum viable experiment", "should we…

wondelai/skills · 149 tokens