Agent skill

Arkcli Billing

by volcengine in volcengine/ark-cli

查询火山引擎 ARK 拆分账单明细(结算金额、Token 用量计费),支持按账期月、月范围、Endpoint、API Key、产品编码等维度过滤。当用户问账单、花了多少钱、对账、账期、按 EP / API Key 拆账、按产品拆账、月度账单、出账明细时使用。注意 billing 跟 usage stats 不同:stats 出推理量(近实时),billing 出结算金额(T+1 出账,财务口径)。

Apache-2.0Auto-check passedMedia & Creative

Install Arkcli Billing

skills CLI
$ npx skills add volcengine/ark-cli --skill arkcli-billing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install volcengine/ark-cli arkcli-billing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/volcengine/ark-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/arkcli-billing .claude/skills/arkcli-billing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
arkcli-billing
GitHub stars
140
Token cost
~1.2k tokens
SKILL.md length
410 words
Files
2 (incl. references)
Skills in repo
25
Repo updated
First seen
Licence
Apache-2.0

At a glance

查询火山引擎 ARK 拆分账单明细(结算金额、Token 用量计费),支持按账期月、月范围、Endpoint、API Key、产品编码等维度过滤。当用户问账单、花了多少钱、对账、账期、按 EP / API Key 拆账、按产品拆账、月度账单、出账明细时使用。注意 billing 跟 usage stats 不同:stats 出推理量(近实时),billing 出结算金额(T+1 出账,财务口径)。

  • Media & Creative work in your project
  • SKILL.md covers 适用场景, 业务定位 — billing vs usage stats, Step 0:确认账单口径与范围 and 快速决策, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Arkcli Billing is an agent skill from volcengine/ark-cli. 查询火山引擎 ARK 拆分账单明细(结算金额、Token 用量计费),支持按账期月、月范围、Endpoint、API Key、产品编码等维度过滤。当用户问账单、花了多少钱、对账、账期、按 EP / API Key 拆账、按产品拆账、月度账单、出账明细时使用。注意 billing 跟 usage stats 不同:stats 出推理量(近实时),billing 出结算金额(T+1 出账,财务口径)。

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/arkcli-billing-list.md`).

It sits in Media & Creative. The repository describes itself as: The fastest way to put Volcengine Ark in your terminal and your AI agent — go from prompt to generated media, multimodal answer, or deployed endpoint in a single command, no API… The licence is Apache-2.0.

When your agent uses it

  • Media & Creative work in your project

Example prompts

  • “/arkcli-billing”

What it can do on your machine

Read from SKILL.md and the folder at commit fb5b7be. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Arkcli Billing loads about 1.2k tokens when it runs, and up to ~4.8k if it reads all its reference files. Until then it costs about 54 tokens; SKILL.md has 410 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from volcengine/ark-cli at commit fb5b7be, republished under its Apache-2.0 licence (© volcengine). 410 words, ~1,152 tokens.

Download SKILL.mdSave it as .claude/skills/arkcli-billing/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
arkcli-billing
description
查询火山引擎 ARK 拆分账单明细(结算金额、Token 用量计费),支持按账期月、月范围、Endpoint、API Key、产品编码等维度过滤。当用户问账单、花了多少钱、对账、账期、按 EP / API Key 拆账、按产品拆账、月度账单、出账明细时使用。注意 billing 跟 usage stats 不同:stats 出推理量(近实时),billing 出结算金额(T+1 出账,财务口径)。
version
1.1.3
metadata.cliHelp
arkcli billing list --help

arkcli billing

执行前 MUST 读取 ../arkcli-shared/SKILL.md (认证 / 全局规则) 和 references/arkcli-billing-list.md (参数详解)。

适用场景

  • 查询某账期月或月范围内的拆分账单明细(结算金额 / Token 用量)
  • 按 Endpoint、API Key、产品编码、账单类型过滤拆账行
  • 月度 / 季度 / 年度对账
  • 排查"这个 EP / 这把 key 花了多少钱"

业务定位 — billing vs usage stats

维度usage statsbilling list
数据源ARK BFF 推理聚合火山计费中心拆账
时效5–30 分钟延迟T+1 出账
单位Token / 请求数CNY 金额

想看"用了多少 token"→ arkcli-usage;想看"花了多少钱"→ 本 skill。

Step 0:确认账单口径与范围

先分清“已结算金额”与“Token / 套餐额度消耗”,后者交给 Usage,不用单价乘估算 Token 冒充账单。用户只查某个 Endpoint、Key 或订阅时,仅查其明确范围;profile.type=platform 不能证明没有套餐。

身份上下文已知则复用,确需核实时按共享宿主协议使用 arkcli auth whoami --format json;托管宿主的注入协议优先。普通账单查询不调用可能同步/回写 Key 的 profile show/list/keys list,不为了补全账单切换身份。

  • “我花了多少”先保留 --mine,按下面的本人资源流程查;用户要求订阅类账单时显式 --product ark_subscription,并解释其账号/订阅范围,不称为个人 Endpoint 用量。
  • “整个账号花了多少”才使用账号查询;Project 筛选按本次实际上下文说明,不能为补数擅自清空 Project、换 Profile 或换身份。
  • 每条 billing list 必带 --start <YYYY-MM>,跨月加 --end <YYYY-MM>。账期是月份,不是 Usage 的日级参数;T+1 及当期未出账部分必须披露。
  • 返回的账单数组是 items,不是 Endpoint 列表的 Items。解析失败、请求失败、截断与真实空列表分开报告。

快速决策

用户问命令
我这个月 / 上个月花了多少arkcli billing list --start <YYYY-MM> --mine;明确要订阅账单时按 Step 0 另选产品并披露范围
整个账号花了多少 / 公司账号 / 整体 (无主语自指)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 (默认查询不含)
--mine fallback 流程 (跟 usage stats 对齐)

用户问"我...花了多少"时:

  • 火山: 先 arkcli billing list --start <YYYY-MM> --mine(默认 --mine-by=endpoint)
    • 有数据 → 用 partial_failures 检查截断后,告诉用户金额合计
    • 撞空 (no endpoints owned by current sub-user) → 立即重试 --mine --mine-by=apikey
    • 仍撞空 → 报告“在本次身份、范围和账期内未查到匹配账单”,核对时间、出账延迟和资源范围;不能据此宣称账号零资源或自动切身份
    • ⛔ 禁止退化为不带 --mine 的全量查询 — 全账号金额 ≠ "我花的",一旦丢 --mine 范围语义就跑偏(对齐 arkcli-usage 的同条款)

dim 间 fallback (endpoint→apikey) agent 可以自动重试,因为同 mine 语义、不改查询范围;但不能丢 --mine 退到全量(那是改语义)。

Show full SKILL.md (173 more words)Show less

Agent 关键纪律

  • 保留 stderr:首次查询和用于得出结论的查询不得加 2>/dev/null。账号全量 scope 提示、软截断 WARN 与部分失败原因都可能只写 stderr;需要解析 JSON 时只接管 stdout,或优先使用 --output FILE。
  • is_truncated=true 时停下问用户,不要自动决策 — 撞 cap (preflight 模式下 items 不返,只有 metadata + partial_failures + stderr 警告) 是规模信号不是错误。先把 total_records 和 partial_failures[*].total 报给用户,列出 4 条出路,等用户明确选一个再继续。选哪条要看用户当前任务意图(对账 / 排查 / 导出),agent 不要替用户拍。永远不要 sum items 当总额(items 可能为空或部分):
    • 想要全量明细 → --output FILE (落盘 stdout 不爆;自动放宽 cap 到 300k 行)
    • 只要总金额 → --split-dim apikey|endpoint (服务端聚合到几十行)
    • 缩到一个资源 → --endpoint <ep-...> / --apikey <ark-...>
    • 强行流进 stdout → --page-limit=N (N 见 partial_failures.reason 建议;mind context size)
  • --limit/--offset 在 fan-out 时是 per-fan-out 各 N 行 (--end 跨月或 --mine 多资源时), partial_failures 标 reason="windowed sample", agent 据此知 returned ≤ limit × fanout_count
  • 金额是 CNY 字符串 — JSON 数字精度有损,加和 / 比较用 decimal 库,不要 parseFloat
  • 月初对账拉前一个完整账期 — T+1 出账,当月当日数据不全
  • --mine ≠ PayerID — --mine 按 IAM 子用户过滤资源,PayerID 是财务托管 owner 账号 ID,单账户场景手撸 PayerID 是 no-op (= 全账号查询)。默认 --mine-by=endpoint(infra ownership,对齐 usage stats),要看 cost causation (我的 key 在花钱) 显式 --mine-by=apikey
  • 默认 scope = ARK 推理 / Agent 9 个支持 API Key 分账的产品(不含 ark_subscription,要看订阅类显式 --product ark_subscription) + profile.project 自动注入(若 profile.project 是具体 id 如 auto-test,自动按 project 过滤;default/账号全部资源哨兵/空跳过 = 真账号全量;stderr 出软提示)。要强制账号全量传 --project= (空值清空默认)

常见降级

命令一览

命令说明
billing list拆分账单明细查询(结算金额 × Token 用量)

© volcengine, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/arkcli-billing of volcengine/ark-cli.

  • SKILL.md
  • references/arkcli-billing-list.md

Open the folder on GitHubat commit fb5b7be

Compare with similar skills

Arkcli Billing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Arkcli Billing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Arkcli Billing this skillvolcengine/ark-cli140—~1.2kAutomated safety check: PassApache-2.0
Gh Stackremotion-dev/remotion62k6 repos~2.4kAutomated safety check: PassCustom licence
HyperFrames Media Useheygen-com/hyperframes58k2 repos~2.1kAutomated safety check: PassApache-2.0
Guizang Social Cardsop7418/guizang-social-card-skill7.4k1 repos~7.8kAutomated safety check: PassAGPL-3.0
Weekly Changelog Videoheygen-com/hyperframes58k—~3.3kAutomated safety check: PassApache-2.0
Anthropic Brand Stylinganthropics/skills180k29 repos~559Automated safety check: PassApache-2.0

Similar skills

  • Gh Stack

    remotion-dev/remotion

    Official

    Manages stacked PRs and splits multi-part work into reviewable branches with gh-stack.

    62k GitHub starsUsed in 6 repos~2.4k tokens
    Media & CreativeAuto-check passed
  • HyperFrames Media Use

    heygen-com/hyperframes

    Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.

    58k GitHub starsUsed in 2 repos~2.1k tokens
    Media & CreativeAuto-check passed
  • Guizang Social Cards

    op7418/guizang-social-card-skill

    Produces social card sets for Xiaohongshu and WeChat: carousels, Live Photo motion cards and puzzle layouts, and WeChat cover pairs, rendered from single-file HTML.

    7.4k GitHub starsUsed in 1 repo~7.8k tokens
    Media & CreativeAuto-check passed
  • Weekly Changelog Video

    heygen-com/hyperframes

    Turns a weekly changelog markdown file into a branded HyperFrames video with voiceover, animated mock-UI scenes and captions, using fonts, background and scripts bundled in the skill.

    58k GitHub stars~3.3k tokensUpdated today
    Media & CreativeAuto-check passed
  • Anthropic Brand Styling

    anthropics/skills

    Official

    Applies Anthropic's brand colors and fonts to artifacts such as PowerPoint slides, using fixed hex values for text and accents, Poppins headings and Lora body text.

    180k GitHub starsUsed in 29 repos~559 tokens
    Media & CreativeAuto-check passed
  • MoneyPrinterTurbo Video Generator

    harry0703/MoneyPrinterTurbo

    Installs and runs MoneyPrinterTurbo to turn a topic or script into a finished short video with voice-over, subtitles, stock footage and music.

    129k GitHub stars~2.1k tokensUpdated today
    Media & CreativeAuto-check: warnings

More from volcengine/ark-cli

All 25 skills in this repo
  • Arkcli API Explorer

    volcengine/ark-cli

    Inspect or invoke locally registered ArkCLI actions when product commands cannot cover a task.

    140 GitHub stars~1.3k tokensUpdated 8 days ago
    Auto-check passed
  • Arkcli Code Example

    volcengine/ark-cli

    arkcli +code-example:为指定基础模型生成多语言(Python / Go / Java / Node / curl)调用示例代码并写入本地文件。数据源是火山方舟 OpenTOP OpenGetSampleCode。当用户需要拿某个基础模型的 SDK / curl 调用示例、保存为本地接入模板时使用。反触发:TTS/ASR/语音模型没有 arkcli…

    140 GitHub stars~743 tokensUpdated 8 days ago
    Auto-check passed
  • Arkcli Config

    volcengine/ark-cli

    arkcli 本地配置管理。处理 profile 配置归因、update.mode 的 automatic/disabled 策略、config reset 与历史 yaml 排障;profile 类操作优先使用 arkcli profile <subcmd。

    140 GitHub stars~1.7k tokensUpdated 8 days ago
    Auto-check: notes
  • Arkcli Custommodel

    volcengine/ark-cli

    arkcli 自定义模型仓库管理:从 TOS 导入自定义模型、查询/筛选自定义模型、查看详情、改名、删除、查询可用量化模式、量化已就绪的模型。任何提到自定义模型 ID(cm-)的管理、部署准备,或要求用 cm- 直接对话/推理/试效果的边界判断,都必须使用本 skill。注意:查询火山公共基础模型(doubao 等 foundation models)走 arkcli-models;本…

    140 GitHub stars~2.6k tokensUpdated 8 days ago
    Auto-check passed
  • Arkcli Deploy

    volcengine/ark-cli

    arkcli +deploy:普通创建推理接入点(Endpoint)的统一首选入口。用户说『创建/新建/create 一个 endpoint/接入点』或『部署/上线/deploy 某模型』时优先走这里;但脚本化 / CI / 无护栏 / 原始 raw CRUD 创建是唯一例外,必须改走 arkcli-infer-endpoint,不能由本 skill…

    140 GitHub stars~2.6k tokensUpdated 8 days ago
    Auto-check passed
  • Arkcli Docs

    volcengine/ark-cli

    检索、读取与总结方舟官方文档。用户给出 ark.volcengine.com 文档 URL 或 /docs/ 路径、要求读链接、官方说明、API 契约或必填字段,询问 CC Switch 等第三方客户端的方舟图形配置流程,以及官方网页读取失败时使用。不用于业务调用、资源操作、CLI 帮助或通用知识。

    140 GitHub stars~3.3k tokensUpdated 8 days ago
    Auto-check passed

Questions about Arkcli Billing

What does Arkcli Billing do?

查询火山引擎 ARK 拆分账单明细(结算金额、Token 用量计费),支持按账期月、月范围、Endpoint、API Key、产品编码等维度过滤。当用户问账单、花了多少钱、对账、账期、按 EP / API Key 拆账、按产品拆账、月度账单、出账明细时使用。注意 billing 跟 usage stats 不同:stats 出推理量(近实时),billing 出结算金额(T+1 出账,财务口径)。. Arkcli Billing is an agent skill from volcengine/ark-cli.

When should I use Arkcli Billing?

Arkcli Billing fits situations like: media & Creative work in your project.

How do I install Arkcli Billing in Claude Code?

Run `npx skills add volcengine/ark-cli --skill arkcli-billing -a claude-code`. Or copy the skill folder (skills/arkcli-billing in volcengine/ark-cli) into .claude/skills/arkcli-billing in your project. Claude Code loads it when a task matches its description.

How do I install Arkcli Billing in Codex?

Run `npx skills add volcengine/ark-cli --skill arkcli-billing -a codex`. Or copy the skill folder (skills/arkcli-billing in volcengine/ark-cli) into .agents/skills/arkcli-billing in your project. Codex loads it when a task matches its description.

Can I use Arkcli Billing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add volcengine/ark-cli --skill arkcli-billing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/arkcli-billing, .gemini/skills/arkcli-billing, .github/skills/arkcli-billing and .opencode/skills/arkcli-billing in your project.

What does Arkcli Billing need to run?

SKILL.md names no scripts, command-line tools or credentials: Arkcli Billing is instructions for the agent only.

Does Arkcli Billing access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Arkcli Billing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Arkcli Billing use?

Arkcli Billing is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Arkcli Billing use?

About 1.2k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.6k tokens, read only when the agent opens those files.

What are the alternatives to Arkcli Billing?

Skills that share tags, products or a category with Arkcli Billing: Gh Stack (remotion-dev/remotion, 62k stars), HyperFrames Media Use (heygen-com/hyperframes, 58k stars), Guizang Social Cards (op7418/guizang-social-card-skill, 7.4k stars) and Weekly Changelog Video (heygen-com/hyperframes, 58k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Arkcli Billing?

volcengine (a GitHub organization) maintains it in volcengine/ark-cli, which has 140 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on September 29, 2026.

Source: volcengine/ark-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.