Getting it into your agent
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/volcengine/ark-clinpx agentmods add skills/volcengine/ark-cli/arkcli-doctorWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/volcengine/ark-cli/arkcli-doctor)<a href="https://agentmods.dev/skills/volcengine/ark-cli/arkcli-doctor"><img src="https://agentmods.dev/badge/skills/volcengine/ark-cli/arkcli-doctor/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/volcengine/ark-cli/arkcli-doctor"><img src="https://agentmods.dev/badge/skills/volcengine/ark-cli/arkcli-doctor.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector warn
SkillSpector: 4 findings, up to medium
These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →
- medium Prompt Injection · line 25 Large whitespace padding was detected (a block of blank lines or a long run of spaces). This can push injected instructions below or to the right of the visible area so a human reviewer never sees them while the agent still reads them. Manual review of the hidden content is recommended.Fix: Remove the large whitespace padding (blank-line blocks or long space runs) and review any content hidden below or to the right of it. Keep skill files compact and reviewable so no instructions can be
- medium Prompt Injection · line 123 Large whitespace padding was detected (a block of blank lines or a long run of spaces). This can push injected instructions below or to the right of the visible area so a human reviewer never sees them while the agent still reads them. Manual review of the hidden content is recommended.Fix: Remove the large whitespace padding (blank-line blocks or long space runs) and review any content hidden below or to the right of it. Keep skill files compact and reviewable so no instructions can be
- medium Prompt Injection · line 136 Large whitespace padding was detected (a block of blank lines or a long run of spaces). This can push injected instructions below or to the right of the visible area so a human reviewer never sees them while the agent still reads them. Manual review of the hidden content is recommended.Fix: Remove the large whitespace padding (blank-line blocks or long space runs) and review any content hidden below or to the right of it. Keep skill files compact and reviewable so no instructions can be
- medium Prompt Injection · line 176 Large whitespace padding was detected (a block of blank lines or a long run of spaces). This can push injected instructions below or to the right of the visible area so a human reviewer never sees them while the agent still reads them. Manual review of the hidden content is recommended.Fix: Remove the large whitespace padding (blank-line blocks or long space runs) and review any content hidden below or to the right of it. Keep skill files compact and reviewable so no instructions can be
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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00217 | $0.07122 |
| Opus 5.5 | $0.00087 | $0.02849 |
| Sonnet 5.5 | $0.00043 | $0.01424 |
| Haiku 4.5 | $0.00022 | $0.00712 |
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 17d 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.
How it starts
The opening of the file, as written. The whole thing — 303 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 创建来源特征验证任务并轮询官方结果 |
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.
- CONTRIBUTING.md 10 KB
- references/error-codes.md 43 KB
- references/evals.md 2.1 KB
- references/scope-account.md 18 KB
- references/scope-cli.md 19 KB
- references/scope-infer-endpoint.md 22 KB
- references/scope-metrics.md 13 KB
- references/scope-model.md 23 KB
- references/scope-report.md 22 KB
- references/verify-origin.md 3.9 KB
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.
- 17d ago Changed · +14 lines · +9 tokens per session 75004ccab68e
- 29d ago Changed · +8 lines bd10e23914ed
- 1mo ago First seen · 281 lines · 208 tokens per session scan A f75fe6a13b22
arkcli-doctor is a skill published in the GitHub repository volcengine/ark-cli (143 stars, last pushed 8d ago), licensed Apache-2.0. It adds 217 tokens to every session and 7,122 once invoked, about $0.0009 per session on Opus 5.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.
Other skills, from other repositories
optimization
Use when improving performance, latency, throughput, memory usage, or general efficiency. Start by defining target metrics, measuring comprehensively, attributing bottlenecks, validating with static analysis, and prioritizing macro-optimizations before micro-optimizations.
smiles-validation
Strict SMILES validation, structural comparison, and modification verification. Catches invalid LLM-generated molecules.
ix
Answer structural questions about a codebase — what a symbol is, what calls it, what a change breaks, where the hotspots are — from a persistent code graph via the ix CLI, instead of grepping.
triage
Diagnose and fix broken MCP servers in mcptoon — doctor, health, per-server probes, and the common failure playbook.
knowledge-extension-ecosystem-lsp-code-intelligence
A codebase guide to LSP, the standard protocol behind editor features such as symbol queries, file diagnostics, and language-aware code information.
pi-observability-local-dev
Use when developing or reviewing packages/pi-observability dashboard/server changes locally, especially rebuilding dist, restarting the 43190 server, validating UI behavior, or keeping the local dashboard in sync with source edits.