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.
npx skills add volcengine/ark-cli --skill arkcli-understandgit clone --depth 1 https://github.com/volcengine/ark-cliWrote 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-understand)<a href="https://agentmods.dev/skills/volcengine/ark-cli/arkcli-understand"><img src="https://agentmods.dev/badge/skills/volcengine/ark-cli/arkcli-understand/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-understand"><img src="https://agentmods.dev/badge/skills/volcengine/ark-cli/arkcli-understand.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
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.00087 | $0.03312 |
| Opus 5.5 | $0.00035 | $0.01325 |
| Sonnet 5.5 | $0.00017 | $0.00662 |
| Haiku 4.5 | $0.00009 | $0.00331 |
Grade A, and why
arkcli-understand 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 today.
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 — 121 lines — stays where its author put it; the contents beside it link to each section on GitHub.
arkcli +understand
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../arkcli-shared/SKILL.md，其中包含认证闸门、API Key 错误恢复、配置排查与命令选择顺序。
CRITICAL — 执行 +understand 之前，MUST 先用 Read 工具读取 references/arkcli-understand.md（命令/flag/返回值/错误）与 references/sub-skills.md（12 个 sub-skill 的用途与期望输出形态）。禁止凭印象拼命令。
先区分理解任务与调用问题
| 本轮要交付什么 | 执行边界 |
|---|---|
| 对具体素材转写、抽取、翻译或定位 | 使用本 Skill 的配方；缺少素材时补齐输入，不能凭空生成素材或理解结果 |
| 解释音频/多模态参数、比较接口，或排查已有请求的字段报错 | 读取 ../arkcli-chat/SKILL.md 的请求证据与条件修复；本轮交付诊断说明，到此结束，不进入后文业务准备 |
| 同时要求解释错误并实际处理素材 | 分开记录两项交付；只在已提供素材、调用目标和实际执行授权的范围内处理，不用新请求的结果替代原错误证据 |
+understand 的实现走 Responses API，只能说明这个 CLI 命令的行为，不能说明用户原来的音频 SDK、Chat 请求或网关也走 Responses。单凭 unknown field 不能判定实际接口；原 URL、模型版本或请求体缺失时保留未知，按 Chat Skill 给出条件分支。仅有“音频理解”“转写参数”等字样不会启动配方执行。
参数诊断无需先准备认证、解析默认资源或选择下表的 fallback 模型。用户未提供原模型时，不自行选另一个模型查询上限并据此解释原请求；已知模型的只读能力查询也须在本次允许的工具范围内。只有本轮确实要求实际处理素材或授权复现，才进入后文执行顺序。
核心概念
+understand不是 12 套实现，而是 1 个引擎 + 一层语义：底层引擎就是+chat用的数据面 Responses API；每个 sub-skill 只是一条配方{模态, fallback 模型, 内置 system prompt}。Platform Profile 省略--model时必须使用当前 Profile 的Resources.Text.DefaultEndpoint；只有 Plan 类 Profile 才使用 recipe fallback 模型。- 命令形态：
arkcli +understand <sub-skill> --input @file [prompt]。args[0]命中注册表（12 个之一）→ 当作显式 sub-skill，其余位置参数当 prompt 叠加在内置 prompt 之上。args[0]不命中 → 整段位置参数都当 prompt，服务端按首个--input的文件模态自动路由到该模态的默认 sub-skill。
- 必须有
--input：sub-skill 是「对某个文件做理解」，没有--input会直接missing_input报错。纯 prompt 无法推导配方。 - 返回值与
+chat完全一致：arkcli 扁平 schema{id, model, content, reasoning_content, usage}，不是 Responses 原生output[].content[].text嵌套。详见references/arkcli-understand.md的「返回值」段。 - 多模态上传：image/video/doc 由 SDK
file://preprocessor 自动走 Files API；audio 是特例——内联为 base64 data URL，上限 25MB。详见 reference。 - 用户临时提供
--api-key/--base-url/ Endpoint 时，MUST 读取../arkcli-shared/references/execution-context.md。不要根据 Key 文本或 Endpoint 名称猜数据面/工作流。 --dry-run只在本地解析配方、当前 Profile 已持久化的默认 Endpoint、显式模型和输入引用，输出统一preview.v1；不读取在线 Endpoint/模型元数据、不上传文件、不调用 Responses API、不产生模型用量、不创建 response id 或持久化响应。在线才能补齐的值必须标为unresolved，不能把预览当服务端 validation。
What ships with it
3 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.
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.
- today Changed · +12 lines · +1 tokens per session cf4b33ee9cdc
- 1mo ago First seen · 109 lines · 86 tokens per session scan A 90d75827d72b
arkcli-understand is a skill published in the GitHub repository volcengine/ark-cli (143 stars, last pushed today), licensed Apache-2.0. It adds 87 tokens to every session and 3,312 once invoked, about $0.0003 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
plugin-system
Generic plugin system for Python applications. Auto-discovery, validation, fault tolerance. Zero dependencies (Python stdlib only).
batch-file-ops
Batch-Dateioperationen (Löschen, Verschieben, Kopieren, Auflisten) mit Glob-Mustern. CLI-Werkzeug für effiziente Dateisystem-Operationen. Ohne Abhängigkeiten.
datamol
Pythonic wrapper around RDKit with simplified interface and sensible defaults. Preferred for standard drug discovery including SMILES parsing, standardization, descriptors, fingerprints, clustering, 3D conformers, parallel processing. Returns native rdkit.Chem.Mol objects. For advanced control or custom parameters…
clinicaltrials-database
Query ClinicalTrials.gov via API v2. Search trials by condition, drug, location, status, or phase. Retrieve trial details by NCT ID, export data, for clinical research and patient matching.
openalex-database
Query and analyze scholarly literature using the OpenAlex database. This skill should be used when searching for academic papers, analyzing research trends, finding works by authors or institutions, tracking citations, discovering open access publications, or conducting bibliometric analysis across 240M+ scholarly…
esm
Comprehensive toolkit for protein language models including ESM3 (generative multimodal protein design across sequence, structure, and function) and ESM C (efficient protein embeddings and representations). Use this skill when working with protein sequences, structures, or function prediction; designing novel…