Agent skill

Arkcli Onboard

by volcengine in volcengine/ark-cli

arkcli 接入向导(workflow):把某个模型接入到自己的应用/服务的端到端引导 —— 从'我想用某模型'到拿到可调用的 Endpoint(+ 可选示例代码)。当用户说'我想在我的 app/服务里用豆包/某模型''怎么把方舟模型接进来''帮我接入 XX 模型''想正式用上某模型'这类不含 deploy/部署关键词、但本质是正式接入的意图时触发。已明确说'部署/创建…

Apache-2.0Auto-check passedMedia & Creative

Install Arkcli Onboard

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

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

GitHub CLI
$ gh skill install volcengine/ark-cli arkcli-onboard --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-onboard .claude/skills/arkcli-onboard && 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-onboard
GitHub stars
140
Token cost
~1k tokens
SKILL.md length
186 words
Files
2 (incl. references)
Skills in repo
25
Repo updated
First seen
Licence
Apache-2.0

At a glance

arkcli 接入向导(workflow):把某个模型接入到自己的应用/服务的端到端引导 —— 从'我想用某模型'到拿到可调用的 Endpoint(+ 可选示例代码)。当用户说'我想在我的 app/服务里用豆包/某模型''怎么把方舟模型接进来''帮我接入 XX 模型''想正式用上某模型'这类不含 deploy/部署关键词、但本质是正式接入的意图时触发。已明确说'部署/创建…

  • Tasks that involve Speech recognition and synthesis
  • SKILL.md covers 离线 / --help 验证模式, 它解决什么, 触发 vs 不触发 and 编排(每步 delegate,不抄细节), plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Text to speech and voice

What it does

Arkcli Onboard is an agent skill from volcengine/ark-cli. arkcli 接入向导(workflow):把某个模型接入到自己的应用/服务的端到端引导 —— 从'我想用某模型'到拿到可调用的 Endpoint(+ 可选示例代码)。当用户说'我想在我的 app/服务里用豆包/某模型''怎么把方舟模型接进来''帮我接入 XX 模型''想正式用上某模型'这类不含 deploy/部署关键词、但本质是正式接入的意图时触发。已明确说'部署/创建 endpoint'的直接走 arkcli-deploy;只想试效果/问一句的走 +chat/+gen。反触发:TTS/ASR/语音模型接入不走本向导,只能转 models search 说明 arkcli 当前不支持调用/部署/示例/用量/费用/接入。

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

It sits in Media & Creative, covering Speech recognition and synthesis and Text to speech and voice. 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

  • Tasks that involve Speech recognition and synthesis
  • Tasks that involve Text to speech and voice

Example prompts

  • “我想用某模型”
  • “我想在我的 app/服务里用豆包/某模型”
  • “怎么把方舟模型接进来”
  • “/arkcli-onboard”

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 Onboard loads about 1k tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 83 tokens; SKILL.md has 186 words of instructions outside code blocks.

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

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). 186 words, ~1,015 tokens.

Download SKILL.mdSave it as .claude/skills/arkcli-onboard/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
arkcli-onboard
description
arkcli 接入向导(workflow):把某个模型接入到自己的应用/服务的端到端引导 —— 从'我想用某模型'到拿到可调用的 Endpoint(+ 可选示例代码)。当用户说'我想在我的 app/服务里用豆包/某模型''怎么把方舟模型接进来''帮我接入 XX 模型''想正式用上某模型'这类**不含 deploy/部署关键词、但本质是正式接入**的意图时触发。已明确说'部署/创建 endpoint'的直接走 arkcli-deploy;只想试效果/问一句的走 +chat/+gen。反触发:TTS/ASR/语音模型接入不走本向导,只能转 models search 说明 arkcli 当前不支持调用/部署/示例/用量/费用/接入。
version
1.0.1
metadata.cliHelp
arkcli --help

arkcli 接入向导(workflow)

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../arkcli-shared/SKILL.md(认证闸门、命令选择顺序、写操作安全边界)。

本 skill 只负责编排顺序与分支。 每一步的私有命令细节(如 +deploy 的 --model / --name / JSON 字段,models search 的过滤)都在对应能力 skill 里,本文不重复。本文只允许出现跨命令通用的安全护栏(只在叶子命令支持时使用 Client Preview,否则只读核对 + 明确确认);一旦出现某个命令的私有 flag 说明,就是越界。

离线 / --help 验证模式

  • 用户已给出模型且明确禁止远端查询时,跳过 Step 1 的实际 models search/get;不得为了“验证流程”偷偷查询模型或 Endpoint。
  • Step 2 即使只查看帮助,也必须保留当前产品的资源范围语义:运行 arkcli infer endpoint list --mine --help,不能退化成无范围的 list --help,也不能换成 --page-all。
  • --help 模式只验证命令选择,不执行创建、部署、登录或任何真实资源查询。

它解决什么

用户表达的是意图级目标("我想在服务里用豆包"),而不是命令级目标("部署一个 endpoint")。这类口语通常不会命中 arkcli-deploy 的关键词,但本质就是"正式接入 = 需要一个可复用的 Endpoint"。本 skill 把这个意图固化成一条有序、有分支、可回归的链路,逐步 delegate 给 owning skill。

触发 vs 不触发

  • ✅ "我想在我的 app/服务里用豆包" / "怎么把方舟模型接到我的服务" / "帮我接入 seedream" / "想正式用上某模型"
  • ❌ 语音模型接入 / TTS / ASR / 配音 / 朗读 / 播客 / 音色 / 实时语音交互,或模型名命中 doubao-seed-tts-*、doubao-seed-asr-*、seedasr-* → 不走本向导;只转 arkcli-models 做广场发现,并说明当前 arkcli 不支持语音模型调用、部署、示例、用量、费用或接入向导
  • ❌ 用户已说"部署 / 创建 endpoint / deploy" → 直接走 arkcli-deploy(已在 deploy 意图里,不必经本向导)
  • ❌ 只想"试效果 / 问一句 / 生成一张图" → +chat / +gen(试用不需要 Endpoint)
  • ❌ 只想"看示例代码"且已知模型名 → 直接 arkcli-code-example

编排(每步 delegate,不抄细节)

Step 0  认证 + 实名闸门
          └─► 见 arkcli-shared「认证闸门」;命中开通/部署意图先做实名检查
              (../arkcli-auth/references/realname-gate.md)

Step 1  选模型
          └─► arkcli-models(search / get)。用户没指定模型就先帮选、确认再继续
              └─ 命中语音模型(TTS / ASR / 播客 / 音色 / 实时语音交互)即停:
                 只说明广场可搜,当前 arkcli 不支持继续接入

Step 2  查是否已有可复用 Endpoint     ★必查★
          └─► arkcli-infer-endpoint:list --mine("我的"语义见
              ../arkcli-auth/references/identity-resolution.md)
              ├─ 有 EP 且【绑定目标模型/版本】+【状态可用(如 Running)】
              │    多个匹配或不确定时按本轮结果结构化选一个 ─► 跳到 Step 4(复用其 endpoint-id)
              └─ 无匹配 EP(账号下只有别的模型的 EP 不算匹配)─► Step 3

Step 3  创建 Endpoint                 ★唯一写操作★
          └─► arkcli-deploy:只读核对 + 与用户确认,再真建(不支持 --dry-run)
              (二次确认协议见 arkcli-shared)

Step 4  (可选) 生成调用示例
          └─► arkcli-code-example:按 model-version 提供,覆盖不全;
              缺失时降级到方舟控制台示例页,不当作失败报给用户

Step 5  回执
          └─► 给出 endpoint-id + 一句话"怎么在代码里用它",回到用户原始目标

关键约束

  • Step 2 必查、但只复用"匹配"的:仅当 list --mine 里存在绑定目标模型/版本且**状态可用(如 Running)**的 endpoint 才跳过 Step 3 复用它;账号下别的模型的 endpoint 不算匹配,不能拿来顶。多个匹配时,使用宿主结构化选择能力展示本轮结果中的 endpoint-id、绑定模型/版本、状态和名称;宿主不支持时才退化为精简编号列表。用户选定后直接复用该 ID,不重新查询同一批结果,也不把“选中已有 Endpoint”当成授权创建新资源。无匹配就正常走 Step 3 创建。
  • 语音模型不是 onboarding 目标:广场可搜到的语音模型只代表可发现,不代表 arkcli 可调用、可部署、可生成示例、可查用量/费用;Step 1 一旦确认是语音模型,流程必须停止,不进入 Step 2-Step 4。
  • 不要补替代接入路径:语音模型命中后只回答 arkcli 边界;不要主动推荐控制台 / OpenAPI / SDK 接入步骤或链接。
  • Step 3 是唯一写操作:套用 ../arkcli-shared/SKILL.md 的二次确认 + 实名闸门;+deploy 不支持 --dry-run,用户语气再急也要先只读核对并确认。
  • Step 4 可选、可降级:+code-example 的示例按 model-version 提供,部分版本后端无 group 会返回 not found;这是预期内的覆盖缺口,降级到控制台示例页即可,不要把它当链路失败。
  • 全程是编排:每一步把控制权交给 owning skill,不在本文复述其参数。

参考

© 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-onboard of volcengine/ark-cli.

  • SKILL.md
  • references/evals.md

Open the folder on GitHubat commit fb5b7be

Compare with similar skills

Arkcli Onboard 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 Onboard compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Arkcli Onboard this skillvolcengine/ark-cli140—~1kAutomated safety check: PassApache-2.0
Dotty Av TestBrettKinny/dotty-stackchan113—~866Automated safety check: NotesMIT
Stepfun Asrdaymade/claude-code-skills1.4k—~3kAutomated safety check: PassMIT
Stepfun Ttsdaymade/claude-code-skills1.4k—~2.5kAutomated safety check: PassMIT
Groq Core Workflow Bjeremylongshore/tons-of-skills-marketplace2.8k—~1.4kAutomated safety check: PassMIT
Voice AI Ttssundial-org/awesome-openclaw-skills663—~2.3kAutomated safety check: NotesNone

Similar skills

  • Dotty Av Test

    BrettKinny/dotty-stackchan

    Run local black-box voice tests against the physical Dotty robot by playing a TTS prompt through the workstation speakers while the C920 records video and room audio.

    113 GitHub stars~866 tokensUpdated 2 days ago
    Media & CreativeAuto-check: notes
  • Stepfun Asr

    daymade/claude-code-skills

    Transcribes Chinese/English audio with StepFun's stepaudio-3-asr-max via its SSE endpoint (not /v1/audio/transcriptions) — one call handles long-form audio with no chunking.

    1.4k GitHub stars~3k tokensUpdated today
    Media & CreativeAuto-check passed
  • Stepfun Tts

    daymade/claude-code-skills

    Generates Chinese/Japanese speech with StepFun's Contextual TTS — default stepaudio-2.5-tts, stepaudio-3-tts for whisper/inline-() prosody.

    1.4k GitHub stars~2.5k tokensUpdated today
    Media & CreativeAuto-check passed
  • Groq Core Workflow B

    jeremylongshore/tons-of-skills-marketplace

    A skill your agent uses when you need Groq's non-chat endpoints — transcribing or translating audio with Whisper, understanding images with Llama 4 vision, generating speech (TTS), or benchmarking…

    2.8k GitHub stars~1.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Voice AI Tts

    sundial-org/awesome-openclaw-skills

    High-quality voice synthesis with 9 personas, 11 languages, streaming, and voice cloning using Voice.ai API.

    663 GitHub stars~2.3k tokensUpdated 7 mo ago
    Media & CreativeAuto-check: notes
  • Video Reference

    zenstory-ai/video-recap-skills

    按需把一部成片拆成可复用的制作参考:测镜头节奏与响度,标注段落与音轨分工,把原片事实与可迁移方法分开, 导出不含原片人名台词的 productionreference.json 供下次制作参考。不在默认生产路径上。

    555 GitHub starsUsed in 1 repo~1.3k tokens
    Media & CreativeAuto-check passed

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 Onboard

What does Arkcli Onboard do?

arkcli 接入向导(workflow):把某个模型接入到自己的应用/服务的端到端引导 —— 从'我想用某模型'到拿到可调用的 Endpoint(+ 可选示例代码)。当用户说'我想在我的 app/服务里用豆包/某模型''怎么把方舟模型接进来''帮我接入 XX 模型''想正式用上某模型'这类不含 deploy/部署关键词、但本质是正式接入的意图时触发。已明确说'部署/创建…. Arkcli Onboard is an agent skill from volcengine/ark-cli.

When should I use Arkcli Onboard?

Arkcli Onboard fits situations like: tasks that involve Speech recognition and synthesis; tasks that involve Text to speech and voice.

How do I install Arkcli Onboard in Claude Code?

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

How do I install Arkcli Onboard in Codex?

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

Can I use Arkcli Onboard 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-onboard -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-onboard, .gemini/skills/arkcli-onboard, .github/skills/arkcli-onboard and .opencode/skills/arkcli-onboard in your project.

What does Arkcli Onboard need to run?

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

Does Arkcli Onboard 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 Onboard 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 Onboard use?

Arkcli Onboard 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 Onboard use?

About 1k tokens (SKILL.md is roughly 4.1k 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 956 tokens, read only when the agent opens those files.

What are the alternatives to Arkcli Onboard?

Skills that share tags, products or a category with Arkcli Onboard: Dotty Av Test (BrettKinny/dotty-stackchan, 113 stars), Stepfun Asr (daymade/claude-code-skills, 1.4k stars), Stepfun Tts (daymade/claude-code-skills, 1.4k stars) and Groq Core Workflow B (jeremylongshore/tons-of-skills-marketplace, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Arkcli Onboard?

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.