arkcli-config

A local configuration manager for ARK profiles. A profile is a saved set of connection and account settings used to choose the right environment, project, and API keys.

In plain words
What is it for?
Use it to list, inspect, create, switch, or delete profiles, or to reset all local ARK settings.
Why use it?
It helps explain why a command reached the wrong account, environment, or web address, and replaces older configuration commands that are being retired.

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

Made for: Claude Code, Codex.

Per session 51 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,431 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.00051 $0.02431
Opus 5 $0.00026 $0.01215
Sonnet 5 $0.00010 $0.00486
Haiku 4.5 $0.00005 $0.00243

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

Security

Grade A, and why

arkcli-config 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-config/SKILL.md · 134 lines

How it starts

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

arkcli config

⚠️ 0.1.16 起命令树迁移arkcli config init/list/show/switch/delete 已标记 deprecated,请改用 arkcli profile create/list/show/use/delete(行为一致 + 新增 profile 切面字段 type/project/owner_trn/available_api_keys)。arkcli config reset 保留(清整个本地状态,超出单 profile)。0.2.x 删除全部已 deprecated 子命令。

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../arkcli-shared/SKILL.md,其中包含认证闸门、命令选择顺序与共享安全规则 CRITICAL — 配置类写操作前必须确认用户意图;只读排障优先 list/show,禁止上来直接改配置。

唤起信号(When To Trigger)

  • 用户提到:profilebase-urlapi-key 覆盖混乱,或仍在使用已删除的全局 --region/--project-name
  • 用户现象:同一条业务命令“打到了错误环境/错误 base URL/错误账号”,怀疑是配置来源不一致
  • 用户目标:初始化/更新 profile、切换默认 profile、重置本地配置文件
  • 用户目标:启用、关闭或恢复 arkcli 的自动更新/更新提示策略

反唤起信号(When NOT To Trigger)

  • 用户要解决的是“未登录/401/鉴权失败/没有权限”:先走 arkcli auth status,必要时转 ../arkcli-auth/SKILL.md
  • 用户目标是业务功能(models/+chat/+gen/+deploy/usage 等):不要停留在 config,排除配置后回到原任务

适用场景

  • 初始化或更新 profile
  • 查看当前解析后的配置
  • 切换默认 profile
  • 删除单个 profile 或重置整个本地配置
  • 排查为什么业务命令连到了错误环境、错误账号或错误 base URL

Agent 快速执行顺序

  1. 不确定当前生效配置时,先用 arkcli profile show(旧 arkcli config show 已 deprecated)
  2. 不确定有哪些 profile 时,先用 arkcli profile list
  3. 切换默认 profile:arkcli profile use <name>
  4. 创建 profile:arkcli profile create --type=...(详见 arkcli-profile 子树,本 skill 不重复)
  5. arkcli config reset 是破坏性操作(清整个本地配置文件),必须确认用户意图
  6. 更新策略只使用 allowlist 命令:arkcli config set update.mode automatic|disabled

配置归因(优先级)

arkcli 的解析优先级(从高到低):

  • Profile 选择: --profile flag > ARK_PROFILE 环境变量 > config.yamldefault_profile > 第一个 type=platform 的 profile > "default" sentinel
  • API Key: --api-key > ARK_API_KEY > profile > 同 identity store > 产品 .env 兼容值
  • Base URL: --base-url > ARK_BASE_URL > profile 自定义值 > 按 Profile 的 Region/Type 派生 > 默认值
  • Region/Project: 由所选 Profile 持有;ARK_REGION / ARK_PROJECT_NAME 不再覆盖运行时

--api-key/--base-url 仅供数据面命令使用。无 Profile 时必须成对提供;覆盖 Base URL 时也必须显式提供 API Key。控制面/本地命令显式收到这两个 flag 会 fail-fast。

排障时要明确”是谁覆盖了谁”,不要直接猜测。

Read the full file on GitHub · 134 lines

Files

What ships with it

3 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 · 134 lines · 51 tokens per session scan A dd6ab931da6a

Subscribe to this mod's changes

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