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-agentnpx skills add volcengine/ark-cli --skill arkcli-agentgit 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.00055 | $0.03917 |
| Opus 5 | $0.00028 | $0.01959 |
| Sonnet 5 | $0.00011 | $0.00783 |
| Haiku 4.5 | $0.00006 | $0.00392 |
Grade A, and why
arkcli-agent 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 — 138 lines — stays where its author put it; the contents beside it link to each section on GitHub.
arkcli agent
CRITICAL — 开始前 MUST 先读取 ../arkcli-shared/SKILL.md。
当用户需要创建、查询、调试或联通 ARK Managed Agent 时使用本 skill。核心原则：先用稳定产品命令，不要直接猜 OpenTOP Action；Session 运行时资源、事件、线程、Files API 走数据面直联；MCP OAuth 登录先查后端 provider，再用 arkcli agent +mcp-login。
执行前按“先选路径”读取对应 reference；只读相关 reference，不需要一次性加载全部细节。用户请求如果已经明确是创建、复制、挂文件、聊天、MCP 登录等写操作，完成必要确认/消歧后直接执行，不要只给命令建议。
创建 Agent 的最小决策表
| 用户输入 | AI Agent 的处理 |
|---|---|
| 未指定模型 | 先用 agent model list --query 从 Managed Agent 白名单中选择精确 items[].model，不要凭印象拼模型 ID |
| 未指定 Skill | 先查本账号 custom skill；没有合适候选再查 market/SkillHub skill |
| 给出本地 Skill zip | 先调用 agent skill create --zip，拿到返回的 skill-... ID 和版本后再创建 Agent |
| 未指定工具 | 使用 CLI 注入的完整默认工具集；显式传 --tool 时全量替换默认工具 |
| 未指定环境 | 创建 Session 时自动选择当前项目最新环境；没有可用环境才提示创建或传入环境 ID |
| 创建成功 | 必须回读 agent agent get <agent-id> --format json，展示服务端最终的 Model、System、Tools、Skills、McpServers 和扩展配置 |
| 用户期待 Agent 回复 | 短请求使用 +new session ... --message 或 events send ... --stream；大 payload / 长耗时任务使用 events send --poll，或 send 立即返回后按 cursor 轮询 events / 使用 +tail，不要让所有任务都阻塞等待 |
先选路径
| 用户意图 | 首选命令 | 细节 |
|---|---|---|
| 创建 / 更新 / 删除 Managed Agent | arkcli agent agent ... |
references/agent.md |
| 复制已有 Agent 并改名 / 局部覆盖配置 | arkcli +new-agent --fork <agent-id> [--name <new-name>] |
references/agent.md |
| 为创建 Agent 选择可用模型 | arkcli agent model list |
references/agent.md |
| 创建 Agent 时选择 Skill | 默认先查 custom，未命中再查 market；用户明确指定 market 时跳过 custom | references/skills.md |
| 查询/使用本账号 custom skill | 先 agent skill list --source custom --limit 100，无匹配时沿 NextPage 传 --page 继续；需要完整候选时再用 --page-all / --skill <skill-id> |
references/skills.md |
| 上传本地 custom skill zip | arkcli agent skill create --zip <file> 或 agent agent create --skill-zip <file> |
references/skills.md |
| 管理 custom Skill 版本 / 删除 Skill | 先完整列出版本，再按“非 latest → latest → Skill”的依赖顺序删除 | references/skills.md |
| 创建运行环境 / 会话 | arkcli agent env ... / arkcli agent session ... |
references/session-files.md |
| Environment 初始化脚本 | arkcli agent env create/update --setup-script @./bootstrap.sh |
references/session-files.md |
| Session 一次性覆盖 Agent / Environment | arkcli agent session create --agent-overrides ... --environment-overrides ... |
references/session-files.md |
| Session 创建时绑定 TOS 目录 | 用户明确提供地址后使用 arkcli agent session create --tos-path tos://<bucket>/<prefix>/；未提供时先询问，不猜路径 |
references/session-files.md |
| 选择/继续 Managed Agent 会话 | arkcli +new session |
references/events-chat.md |
| 直接创建新会话并聊天 | arkcli +new session <agent-id> --environment-id <env-id> |
references/events-chat.md |
| 给已有会话发消息或实时看回复 | 默认 events send 只负责写入；需要 SSE 回复时加 --stream 自动跟随 event cursor（--wait 保留为兼容别名），实时入口默认请求 agent.message / agent.thinking Event Deltas；也可使用 +tail/events stream，--no-event-deltas 回退完整事件；+new session/+iterate 内部自动使用补偿 channel |
references/events-chat.md |
| 看 session 诊断 / 导出诊断包 | arkcli +debug <session-id> / arkcli +export <session-id> |
references/debug-export.md |
| 上传文件并挂到已有 session | arkcli agent session resources add <session-id> --path <file> |
references/session-files.md |
| 只上传 / 查询 Files API 文件 | arkcli agent file upload/list/get/wait/delete |
references/session-files.md |
| 管理 memory store / memories | arkcli agent memory-store ... |
references/interfaces-gaps.md |
| 查询可挂载 MCP / 管理 Vault / Credential / MCP OAuth | arkcli agent vault oauth-provider list / arkcli agent vault ... / arkcli agent +mcp-login ... |
references/mcp-vault.md |
What ships with it
7 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 · 138 lines · 55 tokens per session scan A b82b464bd5ca
arkcli-agent is a skill published in the GitHub repository volcengine/ark-cli (112 stars, last pushed 5d ago), licensed Apache-2.0. It adds 55 tokens to every session and 3,917 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.
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…