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 agentmods add skills/volcengine/ark-cli/arkcli-billingnpx skills add volcengine/ark-cli --skill arkcli-billinggit clone --depth 1 https://github.com/volcengine/ark-cliWhat 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 | $0.00128 | $0.02314 |
| Opus 5 | $0.00064 | $0.01157 |
| Sonnet 5 | $0.00026 | $0.00463 |
| Haiku 4.5 | $0.00013 | $0.00231 |
Grade A, and why
arkcli-billing 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.
How it starts
The opening of the file, as written. The whole thing — 97 lines — stays where its author put it; the contents beside it link to each section on GitHub.
arkcli billing
执行前 MUST 读取 ../arkcli-shared/SKILL.md (认证 / 全局规则) 和 references/arkcli-billing-list.md (参数详解)。
适用场景
- 查询某账期月或月范围内的拆分账单明细(结算金额 / Token 用量)
- 按 Endpoint、API Key、产品编码、账单类型过滤拆账行
- 月度 / 季度 / 年度对账
- 排查"这个 EP / 这把 key 花了多少钱"
业务定位 — billing vs usage stats
| 维度 | usage stats |
billing list |
|---|---|---|
| 数据源 | ARK BFF 推理聚合 | 火山计费中心拆账 |
| 时效 | 5–30 分钟延迟 | T+1 出账 |
| 单位 | Token / 请求数 | CNY 金额 |
想看"用了多少 token"→ arkcli-usage;想看"花了多少钱"→ 本 skill。
Step 0(MUST):查"我的账单"先按 profile 路由
跟 arkcli-usage 的 Step 0(canonical 原则)同一套 —— 先查"自己这档 profile 的套餐账单",再查 endpoint 账单。查任何"我…花了多少"前必走:
- 探 profile.type:
arkcli profile show --format json,读type - 定模态:用户点名模型/模态 → 只查该模态;没点名 → 全模态都覆盖
- 按 (type × modality) 路由(
①→②= 先套餐账单、再 endpoint 账单;单格 = 只查 endpoint 账单):
| profile.type | text | image / video |
|---|---|---|
agent-plan / agent-plan-team |
① arkcli billing list --start <YYYY-MM> --product ark_subscription② arkcli billing list --start <YYYY-MM> --mine |
同 text(全模态都先套餐、再 endpoint) |
coding-plan / coding-plan-team |
① arkcli billing list --start <YYYY-MM> --product ark_subscription② arkcli billing list --start <YYYY-MM> --mine |
arkcli billing list --start <YYYY-MM> --mine(套餐不覆盖) |
platform |
arkcli billing list --start <YYYY-MM> --mine(无套餐) |
arkcli billing list --start <YYYY-MM> --mine |
依据同 usage:Agent Plan 套餐覆盖三模态、Coding Plan 套餐只覆盖文本、Platform 无套餐。套餐账单走订阅类必须显式 --product ark_subscription(默认 scope 不含订阅,见下方「Agent 关键纪律」);endpoint 账单 --mine 的撞空 fallback 见下。每条 billing list 必带 --start <YYYY-MM>(月单位,缺省即报 --start is required;查多月范围再加 --end <YYYY-MM>)。
快速决策
| 用户问 | 命令 |
|---|---|
| 我这个月 / 上个月花了多少 (含"我"语义) | 先过 Step 0(本文档顶部):plan profile(agent / coding-text)先 arkcli billing list --start <YYYY-MM> --product ark_subscription 套餐账单、再 arkcli billing list --start <YYYY-MM> --mine endpoint 账单;platform 或非覆盖模态直接 arkcli billing list --start 2026-05 --mine — 撞空有 fallback 流程见下 |
| 整个账号花了多少 / 公司账号 / 整体 (无主语自指) | arkcli billing list --start 2026-05 (账号维度全量) |
| 这个 EP 花了多少 | arkcli billing list --start 2026-05 --endpoint ep-... |
| 这把 key 花了多少 | arkcli billing list --start 2026-05 --apikey ark-... |
| 账号下每个 EP / key 各花了多少 | --split-dim endpoint 或 --split-dim apikey |
| 按天 / 按每条结算明细 | --interval day 配 --day YYYY-MM-DD,或 --interval detail |
| 过去 N 个月对账 | --start ... --end ... (闭区间, 最多 24 个月) |
| 看 Agent Plan / Coding Plan 订阅类账单 | 显式 --product ark_subscription (默认查询不含) |
What ships with it
1 file 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.
- 2d ago First seen · 97 lines · 128 tokens per session scan A abb23e2f7948
arkcli-billing is a skill published in the GitHub repository volcengine/ark-cli (112 stars, last pushed 5d ago), licensed Apache-2.0. It adds 128 tokens to every session and 2,314 once invoked, about $0.0006 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.
Other skills, from other repositories
happiness-skill
当用户问「怎么才能更幸福/为什么得到了还不满足/怎么减少焦虑」时调用。 核心理念: 幸福是缺憾感清空的默认状态, 是可训练的技能; 欲望是与自己的契约(得到前不快乐), 同时只留一个重大欲望; 活在当下。 不适用于: 临床抑郁等需要专业治疗的场景(本书方法不能替代医疗)。 Triggers: 幸福/不快乐/欲望/焦虑/知足/活在当下/happiness/desire/anxiety.
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…
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…
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.
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…
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…