Agent skill

Arkcli Code Example

by volcengine in volcengine/ark-cli

arkcli +code-example:为指定基础模型生成多语言(Python / Go / Java / Node / curl)调用示例代码并写入本地文件。数据源是火山方舟 OpenTOP OpenGetSampleCode。当用户需要拿某个基础模型的 SDK / curl 调用示例、保存为本地接入模板时使用。反触发:TTS/ASR/语音模型没有 arkcli…

Apache-2.0Auto-check passedMedia & Creative

Install Arkcli Code Example

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

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

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

At a glance

arkcli +code-example:为指定基础模型生成多语言(Python / Go / Java / Node / curl)调用示例代码并写入本地文件。数据源是火山方舟 OpenTOP OpenGetSampleCode。当用户需要拿某个基础模型的 SDK / curl 调用示例、保存为本地接入模板时使用。反触发:TTS/ASR/语音模型没有 arkcli…

  • Tasks that involve Speech recognition and synthesis
  • SKILL.md covers 什么时候用, 快速开始, 命令一览 and 输出形态, plus 1 more section
  • Runs Go and Python scripts from its folder
  • Tasks that involve Text to speech and voice

What it does

Arkcli Code Example is an agent skill from volcengine/ark-cli. arkcli +code-example:为指定基础模型生成多语言(Python / Go / Java / Node / curl)调用示例代码并写入本地文件。数据源是火山方舟 OpenTOP OpenGetSampleCode。当用户需要拿某个基础模型的 SDK / curl 调用示例、保存为本地接入模板时使用。反触发:TTS/ASR/语音模型没有 arkcli 示例代码路径,不能靠补版本解决,只能转 models search 说明当前不支持。

Its SKILL.md is about 740 tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files and assets (for example `assets/demo-code/examples.json`, `assets/demo-code/python.py` and `references/arkcli-code-example.md`).

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

  • “/arkcli-code-example”

Requirements

  • Python 3

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

    Ships script files (Go and Python), which the agent can run.

    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 Code Example loads about 743 tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 167 words of instructions outside code blocks.

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

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). 167 words, ~743 tokens.

Download SKILL.mdSave it as .claude/skills/arkcli-code-example/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
arkcli-code-example
description
arkcli +code-example:为指定基础模型生成多语言(Python / Go / Java / Node / curl)调用示例代码并写入本地文件。数据源是火山方舟 OpenTOP OpenGetSampleCode。当用户需要拿某个基础模型的 SDK / curl 调用示例、保存为本地接入模板时使用。反触发:TTS/ASR/语音模型没有 arkcli 示例代码路径,不能靠补版本解决,只能转 models search 说明当前不支持。
version
1.2.0
metadata.cliHelp
arkcli +code-example --help

arkcli +code-example

前置条件: 先阅读 ../arkcli-shared/SKILL.md 了解认证、全局参数和安全规则。

为指定基础模型生成多语言 SDK 调用示例代码,同时写入本地文件。数据源是火山方舟 OpenTOP OpenGetSampleCode。

什么时候用

  • 用户说"生成示例代码 / SDK 示例 / curl 命令 / 怎么调用这个模型",且已经知道模型名
  • 想把某个基础模型的多语言调用模板保存到本地

反路由(不要用本命令):

  • 只是想试模型效果 → ../arkcli-chat/SKILL.md(文本/多模态对话)或 ../arkcli-gen/SKILL.md(出图/视频)
  • 还不知道模型名 → 先 ../arkcli-models/SKILL.md models search/get
  • 需要先创建接入点 → ../arkcli-deploy/SKILL.md
  • 语音模型(TTS / ASR / 配音 / 朗读 / 播客 / 音色 / 实时语音交互,或 doubao-seed-tts-* / doubao-seed-asr-* / seedasr-*)→ 不使用 +code-example。models search 能搜到不代表 OpenGetSampleCode 有示例;不要把后端 ModelVersion required 理解成"补一个版本就能生成",应说明当前 arkcli 不支持语音模型示例代码。

快速开始

bash
# 拿某基础模型的全部语言示例(写入 ./ark-examples/<model>/)
arkcli +code-example --model doubao-seedream-5-0

# 指定版本 + 只看 Python + 结构化输出
arkcli +code-example --model doubao-seedream-5-0 --version 260128 --language python --format json
  • --model 必填,可传基础模型名或合并 ID(doubao-seedream-5-0-260128)
  • --version 可选;不传时 CLI 自动推导(合并 ID 拆版本 → 找 ArkModels 匹配 → GetFoundationModel 取 PrimaryVersion 兜底),全都拿不到才报错要求显式传 --version
  • 内部机制:接口约束 ModelVersion 必填,缺失时 CLI 走上述回退链自动补齐;custom model 走 PrimaryVersion 兜底时 scenario 自动切 finetune_inference,foundation model 无论显式版本或 PrimaryVersion 兜底一律保持 quick_access
  • --language 可选:python / go / java / node / curl(shell 是 curl 别名),默认全部
  • --output-dir 可选,默认 ./ark-examples/<model>
  • --format json 输出结构化条目(含 language / io_type / install / code)
  • 语音模型没有 arkcli 示例代码路径;命中 TTS / ASR / 语音交互时停在 arkcli models search <keyword> 的发现说明,不要继续调用本命令

0.1.17 变更:旧版 --endpoint-id 已移除——新数据源按基础模型取码,不再支持按已有接入点 ID 取码。如需指向某 endpoint,生成后把代码里的 model="..." 手动改成你的 ep-xxx。

命令一览

命令说明
arkcli +code-example --model <name> [--version <ver>] [--language <lang>] [--output-dir <dir>] [--format json]生成多语言示例代码并写入本地

输出形态

  • 本地文件:按"IO 任务类型"分子目录(对齐后端 IOType 维度),同类型下按语言分文件;带安装步骤的语言把安装命令写进文件头注释。
  • 结构化 JSON:--format json 时给出按 (语言 × IO 类型) 展开的条目。
  • 人类可读:默认按后端顺序打印各代码块。

详细参数、目录结构示例、常见链路与 FAQ 见 references/arkcli-code-example.md。

参考

© 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 4 other files (references, assets) in skills/arkcli-code-example of volcengine/ark-cli.

  • SKILL.md
  • assets/demo-code/examples.json
  • assets/demo-code/go/main.go
  • assets/demo-code/python.py
  • references/arkcli-code-example.md

Open the folder on GitHubat commit fb5b7be

Compare with similar skills

Arkcli Code Example 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 Code Example compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Arkcli Code Example this skillvolcengine/ark-cli140—~743Automated safety check: PassApache-2.0
Agentstadaspetra/loop2961 repos~2.5kAutomated safety check: PassMIT
Deepgram Python Text-to-Speechdeepgram/deepgram-python-sdk469—~1.8kAutomated safety check: PassMIT
Speech Engineelevenlabs/skills479—~2.5kAutomated safety check: WarnMIT
Gaik ToolkitGAIK-project/gaik-toolkit100—~5.7kAutomated safety check: PassMIT
AgentCall Join Meetingpattern-ai-labs/agentcall1651 repos~25kAutomated safety check: PassMIT

Similar skills

  • Agents

    tadaspetra/loop

    Build voice AI agents with ElevenLabs. An agent skill from tadaspetra/loop.

    296 GitHub starsUsed in 1 repo~2.5k tokens
    AI & LLM EngineeringAuto-check passed
  • Deepgram Python Text-to-Speech

    deepgram/deepgram-python-sdk

    Guides Python code that calls Deepgram Text-to-Speech v1, covering one-shot REST, streaming WebSocket and the TextBuilder helper.

    469 GitHub stars~1.8k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Speech Engine

    elevenlabs/skills

    Add real-time voice conversations to a custom agent runtime with ElevenLabs Speech Engine.

    479 GitHub stars~2.5k tokensUpdated yesterday
    Media & CreativeAuto-check: warnings
  • Gaik Toolkit

    GAIK-project/gaik-toolkit

    GAIK toolkit overview and reference. An agent skill from GAIK-project/gaik-toolkit.

    100 GitHub stars~5.7k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • AgentCall Join Meeting

    pattern-ai-labs/agentcall

    Joins Google Meet, Teams or Zoom video calls as an AI bot with voice and visual presence through the AgentCall service, in audio, text-to-speech or webpage modes.

    165 GitHub starsUsed in 1 repo~25k tokens
    Productivity & AutomationAuto-check passed
  • Floe Guard

    Floe-Labs/floe-guard

    Know what every AI call really costs — floe-guard meters STT + TTS + LLM + telephony per call (Pipecat, LiveKit — Python & TypeScript), keeps a live ledger of real spend, and hard-stops the next…

    357 GitHub stars~853 tokensUpdated 2 days ago
    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 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
  • Arkcli Doctor

    volcengine/ark-cli

    arkcli doctor 统一入口,覆盖 CLI 健康、account、error、infer-endpoint、model、metrics、report 与 Ark 图片/视频来源特征验证。用户给 1-20 个媒体 URL 并问是否由 Ark/Seedance/Seedream 生成时,走 doctor +verify-origin:整批只披露并确认一次费用,确认前不发…

    140 GitHub stars~4.9k tokensUpdated 8 days ago
    Auto-check passed

Works with

Questions about Arkcli Code Example

What does Arkcli Code Example do?

arkcli +code-example:为指定基础模型生成多语言(Python / Go / Java / Node / curl)调用示例代码并写入本地文件。数据源是火山方舟 OpenTOP OpenGetSampleCode。当用户需要拿某个基础模型的 SDK / curl 调用示例、保存为本地接入模板时使用。反触发:TTS/ASR/语音模型没有 arkcli…. Arkcli Code Example is an agent skill from volcengine/ark-cli.

When should I use Arkcli Code Example?

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

How do I install Arkcli Code Example in Claude Code?

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

How do I install Arkcli Code Example in Codex?

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

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

What does Arkcli Code Example need to run?

Going by SKILL.md and its folder, Arkcli Code Example needs Go and Python for the scripts in its folder. Our summary lists: Python 3.

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

Arkcli Code Example 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 Code Example use?

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

What are the alternatives to Arkcli Code Example?

Skills that share tags, products or a category with Arkcli Code Example: Agents (tadaspetra/loop, 296 stars), Deepgram Python Text-to-Speech (deepgram/deepgram-python-sdk, 469 stars), Speech Engine (elevenlabs/skills, 479 stars) and Gaik Toolkit (GAIK-project/gaik-toolkit, 100 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Arkcli Code Example?

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.