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-modelsnpx skills add volcengine/ark-cli --skill arkcli-modelsgit 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.00145 | $0.06344 |
| Opus 5 | $0.00072 | $0.03172 |
| Sonnet 5 | $0.00029 | $0.01269 |
| Haiku 4.5 | $0.00015 | $0.00634 |
Grade A, and why
arkcli-models 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 — 298 lines — stays where its author put it; the contents beside it link to each section on GitHub.
arkcli models
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../arkcli-shared/SKILL.md,其中包含认证闸门、配置排查与命令选择顺序
CRITICAL — 所有 models 命令在执行之前,务必先用 Read 工具读取其对应的 reference 文档,禁止直接盲目调用命令。
使用原则
- 模型相关需求优先使用
arkcli models ... - 这些命令虽然是标准 CLI 类型,但实现入口仍然来自
shortcuts/models/ - 只有产品命令无法覆盖时,才回退到
../arkcli-api-explorer/SKILL.md - 本 skill 不是默认兜底入口;用户明确问模型查询、模型资产盘点、模型详情或为上游命令挑选模型时才进入
- 语音模型边界:TTS / ASR / 播客 / 音色 / 实时语音交互等语音模型在 arkcli 中只支持广场检索与选型说明;
models search能搜到不代表可+deploy、可+code-example、可查usage或可查pricing。除非用户另问官方文档,不要主动给控制台 / OpenAPI / SDK 等非 arkcli 接入步骤或链接。
适用场景
- 用户要搜索、筛选、对比方舟模型
- 用户要查看模型详情、版本、上下文、模态或 lifecycle 状态
- 用户要统计或列出"我的模型"、"自定义模型"、"最近创建的模型"
- 上游
+chat/+gen/+deploy需要先确定可用模型名 - 用户问语音模型是否存在、有哪些语音模型、TTS/ASR 模型在广场叫什么:只回答广场可搜事实和当前 arkcli 不支持后续场景能力的边界
反唤起信号
- 用户只是要直接对话、生成图片/视频或部署 Endpoint:先转对应 skill,只在缺模型名时回来查模型
- 用户明确要求调用原始 Action、列出 OpenAPI 或构造底层 params:转
arkcli-api-explorer - 用户是鉴权、profile、region、base URL 排障:转
arkcli-auth或arkcli-config - 不要把
arkcli models当默认入口;非模型问题不要先查模型
业务定位
- 本 skill 是其他业务链路的依赖 skill,不是终点 skill
- 它通常服务于三类上游目标:
- 给
+chat/+gen找正确模型 - 给
+deploy确认可部署模型 - 给业务排障确认模型详情和版本
- 给
- 除非用户明确就是在做模型查询,否则查完模型后应回到原始任务
- 例外:语音模型查询本身就是终点。查到
doubao-seed-tts-*、doubao-seed-asr-*、seedasr-*、播客、音色设计、实时语音交互等广场语音模型后,停在"可搜到但 arkcli 不支持调用/部署/示例/用量/费用"说明,不继续交给+deploy/+code-example/usage/pricing/onboard,也不主动补非 arkcli 接入路径。
快速决策
第 0 步(硬闸门):先读场景表,再选命令
这是任何"按意图找模型"需求的第一动作,先于 search / list / resources 的命令选择。MUST 先用 Read 打开 references/arkcli-models-scenario-table.md 判定意图是否命中某个场景标签,然后才决定跑什么命令。 这张人工策展的 场景标签 → 推荐模型 表是意图排序的最高权重信号,压过下方一切命名启发式 / modality / capability 过滤。
易被截胡的反例(必读)——下面这些"闻起来像硬指标"的意图,本质是场景标签,必须先查场景表,不要本能地跳到 --capability / --modality 降级线:
| 用户这么说 | ❌ 别直接 | ✅ 第 0 步命中的场景标签 → 推荐 |
|---|---|---|
| "复杂推理 / 多步骤 / 效果最强的模型" | search --capability thinking |
复杂推理 / Agent 任务 → doubao-seed-2-0-pro |
| "做图片生成用哪个模型" | resources list --modality image 就收手 |
图片生成 → doubao-seedream-5-0 |
| "做视频 / 角色扮演 / 字段抽取" | search --modality ... |
视频生成 / 角色扮演 / 信息抽取 → 查表 |
What ships with it
6 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.
- 2d ago First seen · 298 lines · 145 tokens per session scan A b057c1ebab73
arkcli-models is a skill published in the GitHub repository volcengine/ark-cli (112 stars, last pushed 5d ago), licensed Apache-2.0. It adds 145 tokens to every session and 6,344 once invoked, about $0.0007 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…