arkcli-deploy

A deployment workflow for creating an online inference endpoint from an AI model. Creating one is a real account change that can create a billable resource.

In plain words
What is it for?
Use it to deploy a supported model for online requests and optionally make the new endpoint the default for text, image, or video use.
Why use it?
It connects model selection with endpoint creation and makes the required user confirmation and model activation steps clear.

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

Made for: Claude Code, Codex.

Per session 208 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,849 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.00208 $0.02849
Opus 5 $0.00104 $0.01425
Sonnet 5 $0.00042 $0.00570
Haiku 4.5 $0.00021 $0.00285

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

Security

Grade A, and why

arkcli-deploy 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-deploy/SKILL.md · 87 lines

How it starts

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

arkcli +deploy

前置: 先用 Read 读 ../arkcli-shared/SKILL.md 获取共享认证/配置/写操作守卫规则。

新增 flag --set-default <modality>: 部署成功后自动把新 endpoint 设为 active profile 该 modality (text / image / video) 的默认资源。仅在真实部署成功且用户明确传 modality 时生效;失败仅 stderr warn,不阻断部署主流程。详见 ../arkcli-shared/references/profile-defaults.md

写操作 + 计费+deploy 创建在线推理 Endpoint 是真实写操作,会产生计费资源。该工作流依赖在线探测,不支持 --dry-run;执行前必须与用户显式确认最终参数。

模型开通是独立计费写动作,非交互环境一律不自动开通:若目标基础模型尚未开通,+deploy 会触发"开通模型"(账号级计费写)。在 agent / CI / 管道这类非 TTY 环境,开通被硬拒——--yes 也不放行--yes 只在真人交互终端里用于跳过 [y/N])。命中时 CLI 返回 model_activation_required + console 链接,你必须结束本轮、把"开通(计费)"这件事连同链接交还给真人,由真人在交互终端确认或在网页 console 开通。严禁自己补 --yes / echo Y / 设 ARKCLI_ALLOW_HEADLESS_ACTIVATION 替用户开通——你打印一句"请确认"然后同一轮自己加 --yes 跑掉,等于没问。ARKCLI_ALLOW_HEADLESS_ACTIVATION=1 只留给真·无人值守自动化(CI 流水线),不是 agent 该设的。

实名前置(开通类硬闸门)+deploy 会触发开通模型,第一步arkcli auth statusvolc_sso.identity.verified——false 即停并把实名页 https://console.volcengine.com/user/authentication/detail/ 贴给用户、暂停等待(详见 ../arkcli-auth/references/realname-gate.md)。不要先试 +deploy、撞到 model-id 无效 / 模型未开通报错再回头查实名——那些报错会把你带偏。

语音模型硬边界:TTS / ASR / 配音 / 朗读 / 播客 / 音色设计 / 实时语音交互,或模型名命中 doubao-seed-tts-*doubao-seed-asr-*seedasr-* 时,不要执行 +deploy。这些模型在 arkcli 当前只支持 models search 做广场发现;不能创建 Endpoint,也不能通过开通模型绕过。

示例代码:+deploy 创建后自动渲染 + 独立命令 +code-example

两条路径都可用,都走 OpenTOP OpenGetSampleCode

  • +deploy 创建成功后自动渲染:把该接入点的多语言调用示例写到 ./ark-examples/<ep-id>/(用 ep-id 当作可直接调用的 model id,示例直接调你刚建的接入点),并在 stderr 打一行落盘摘要。best-effort —— 取不到示例只软提示,不影响 Endpoint 创建/启动。
  • 独立命令 arkcli +code-example:按基础模型名/版本单独生成示例,转 ../arkcli-code-example/SKILL.md;注意它按 model-version 提供,部分版本后端无 group 会返回 not found,缺失时再降级到 ark-examples/ 静态示例或方舟控制台示例代码页。

子命令穷举(只有这一个)

Read the full file on GitHub · 87 lines

Files

What ships with it

2 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 · 87 lines · 208 tokens per session scan A 963b31ec17c7

Subscribe to this mod's changes

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