arkcli-usage

A usage-reporting tool for Ark. It shows token and request totals, subscription quota, balances, model-by-model plan usage, and team-seat usage; some reports are delayed by 5–30 minutes.

In plain words
What is it for?
It helps check how much has been used, how much quota remains, what was consumed inside or outside a plan, and which team seat used it.
Why use it?
It helps separate pay-per-use consumption, subscription allowance, balance, and individual team-seat usage instead of treating them as one number.

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-usage
Any agent
npx skills add volcengine/ark-cli --skill arkcli-usage
Clone the repo
git clone --depth 1 https://github.com/volcengine/ark-cli

Made for: Claude Code, Codex.

Per session 242 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,584 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.00242 $0.04584
Opus 5 $0.00121 $0.02292
Sonnet 5 $0.00048 $0.00917
Haiku 4.5 $0.00024 $0.00458

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

Security

Grade A, and why

arkcli-usage 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-usage/SKILL.md · 147 lines

How it starts

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

arkcli usage

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../arkcli-shared/SKILL.md,其中包含认证闸门、配置排查与共享安全规则 CRITICAL — usage stats 在执行之前,务必先用 Read 工具读取 references/arkcli-usage-stats.md,禁止直接盲目调用命令。 CRITICAL — usage plan 在执行之前,务必先用 Read 工具读取 references/arkcli-usage-plan.md,禁止直接盲目调用命令。 CRITICAL — usage plan-details 在执行之前,务必先用 Read 工具读取 references/arkcli-usage-plan-details.md,禁止直接盲目调用命令。 CRITICAL — usage balance 在执行之前,务必先用 Read 工具读取 references/arkcli-usage-balance.md,禁止直接盲目调用命令。 CRITICAL — usage seats 在执行之前,务必先用 Read 工具读取 references/arkcli-usage-seats.md,禁止直接盲目调用命令。

数据时效(务必先看):usage stats 走的是上游 BFF 的聚合管道,数据有 5–30 分钟延迟,定位为「日级 / 聚合分析」。 不要把它用于实时预算监控、限流、实时告警等需要秒级精度的控制场景——这类场景请直接读 +chat / +gen 等推理命令返回里的 .usage 字段(per-request、零延迟,详见 arkcli-chatarkcli-gen)。

语音模型边界:TTS / ASR / 配音 / 朗读 / 播客 / 音色 / 实时语音交互,或 doubao-seed-tts-* / doubao-seed-asr-* / seedasr-* 等广场语音模型,当前在 arkcli 只支持 models search 发现。不要用 usage stats --modelusage plan-details 或套餐/余额命令回答语音模型用量;直接说明 arkcli 不支持查询语音模型费用或用量。

stats / plan / plan-details / balance 区分:

  • stats 出"按 token 计费的 inference 用量"(任何身份,5–30 分钟延迟)
  • plan 出"订阅套餐的 quota 快照"(AgentPlan / CodingPlan 个人版 + 团队版的"我用了几成 / 几号刷新")
  • plan-details 出"AgentPlan 按模型 / 套餐内外的时间序列调用明细"(AgentPlan 个人版 + 团队版,CodingPlan 没有按模型 endpoint)
  • balance 出"还剩多少 X"(余额视角,--type free-quota / media-asset / plan 三选一)
  • seats 出"团队席位用量 admin 视角"(每个 seat 用了多少 / 套餐百分比;只是用量视图)。席位的列表 / 绑定 / 分配 / API Key 轮换arkcli-plansplans team seat-list / seat-assign / rotate-apikey

用户问「我的套餐还剩多少额度」→ planbalance --type plan(后者输出更精简);「我哪个模型用得最多」→ plan-details;「我今天用了多少 token」→ stats;「我还剩多少免费额度 / 媒资库容量」→ balance;「每个 seat 用了多少 / 团队席位用量分布」→ seats --with-usage(纯管理类:谁绑了哪个 seat / 列出席位 / 分配席位 / 轮换 key → arkcli-plans)。

Read the full file on GitHub · 147 lines

Files

What ships with it

5 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 · 147 lines · 242 tokens per session scan A b065a3afc79e

Subscribe to this mod's changes

arkcli-usage is a skill published in the GitHub repository volcengine/ark-cli (112 stars, last pushed 5d ago), licensed Apache-2.0. It adds 242 tokens to every session and 4,584 once invoked, about $0.0012 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

create-business

Guided journey from raw idea to a validated, positioned, priced business with a chosen beachhead. Orchestrates ten skills phase by phase - jobs-to-be-done, mom-test, design-sprint, lean-startup, good-strategy-bad-strategy, blue-ocean-strategy, obviously-awesome, hundred-million-offers, monetizing-innovation…

wondelai/skills · 211 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

asc-subscription-localization

Bulk-localize subscription, subscription-group, and in-app purchase display names across App Store locales using asc, including API 4.4.1 version-scoped v2 resources. Use when filling or updating subscription/IAP names and descriptions without App Store Connect UI work.

rorkai/app-store-connect-cli-skills · 60 tokens

pcbway

PCBWay PCB fabrication and assembly — turnkey/consigned assembly, design rules, ordering workflow. Alternative to JLCPCB for manufacturing. Use with KiCad. Use this skill when the user mentions PCBWay, needs turnkey assembly (PCBWay sources parts by MPN), has parts not available on LCSC, needs assembled boards with…

aklofas/kicad-happy · 119 tokens

scienceworld-growth-focuser

Use when you have planted a seed or need to track a plant's growth stage (sprouting, flowering, reproduction). Applies the 'focus on' action to a specific plant or biological entity to signal intent and monitor its development. Trigger after planting or when you need to observe life cycle progression in the…

zjunlp/SkillNet · 71 tokens