Agent skill

Arkcli Resources

by volcengine in volcengine/ark-cli

arkcli resources 实时控制面查询:列出当前/指定 profile 可见资源及其调用兼容性;把 Endpoint 解析为权威模型、模态与候选工作流。read-only,不写 profile.yaml。用户临时给出 ep-...

Apache-2.0Auto-check passedMedia & Creative

Install Arkcli Resources

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

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

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

At a glance

arkcli resources 实时控制面查询:列出当前/指定 profile 可见资源及其调用兼容性;把 Endpoint 解析为权威模型、模态与候选工作流。read-only,不写 profile.yaml。用户临时给出 ep-...

  • Works in 2 steps: 用户给了 ep-... → arkcli resources resolve… → 不确定当前 profile → arkcli auth whoami…
  • Media & Creative work in your project
  • SKILL.md covers 使用原则, 适用场景, 反唤起信号 and resources vs models 的区别, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Arkcli Resources is an agent skill from volcengine/ark-cli. arkcli resources 实时控制面查询:列出当前/指定 profile 可见资源及其调用兼容性;把 Endpoint 解析为权威模型、模态与候选工作流。read-only,不写 profile.yaml。用户临时给出 ep-... 但未说明该走 Chat、Understand 还是 Gen 时优先使用。反触发:用户已观察到 Endpoint NotFound,并要判断 ID 是否不完整或仅存在于历史用量时,owning skill 必须是 arkcli-infer-endpoint。

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

It sits in Media & Creative. 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

  • Media & Creative work in your project

Example prompts

  • “/arkcli-resources”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. 用户给了 ep-... → arkcli resources resolve --format json,先读 endpoint_model_type 与 model_id,再读 supported_workflows / generation_modality /…
  2. 不确定当前 profile → arkcli auth whoami --format json,读取当前身份及可用的 profile.name / profile.type;字段缺失时按当前编译产品诊断,不猜 type。profile show/list 可能同步并回写本地…

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 (its code samples are json).

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

Always · name and description, kept in context so the agent knows when to use it
~67
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.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). 546 words, ~1,773 tokens.

Download SKILL.mdSave it as .claude/skills/arkcli-resources/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
arkcli-resources
description
arkcli resources 实时控制面查询:列出当前/指定 profile 可见资源及其调用兼容性;把 Endpoint 解析为权威模型、模态与候选工作流。read-only,不写 profile.yaml。用户临时给出 ep-... 但未说明该走 Chat、Understand 还是 Gen 时优先使用。反触发:用户已观察到 Endpoint NotFound,并要判断 ID 是否不完整或仅存在于历史用量时,owning skill 必须是 arkcli-infer-endpoint。
version
1.2.2
metadata.cliHelp
arkcli resources --help

arkcli resources

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../arkcli-shared/SKILL.md,其中包含认证闸门、配置排查与命令选择顺序 CRITICAL — 用户已经看到 Endpoint NotFound,又要核对当前完整 ID / 历史用量时,必须先转读 ../arkcli-infer-endpoint/SKILL.md,由其按 infer endpoint list → usage stats --endpoint 证据链主导。不得只跑 resources resolve/list 就猜测 ID 后缀或宣称已删除。

使用原则

  • arkcli resources 域始终只读。即使用户在资源列表语境中提出创建意图,也必须先转读 ../arkcli-deploy/SKILL.md,不能由本 Skill 创建、修改或删除资源
  • 普通“部署模型并获得 Endpoint”的产品意图继续走 arkcli +deploy。该在线工作流不支持 Client Preview,不得执行 arkcli +deploy --dry-run,也不得为了获得 Preview 而静默降级成底层 CRUD
  • 转入 Deploy Skill 后,先只读核对模型、名称、Region、配置与计费影响并复述给用户;在收到本轮新的明确确认前,不得在同一轮执行真实 arkcli +deploy。严禁 Agent 自行添加 --yes、echo Y 或设置 ARKCLI_ALLOW_HEADLESS_ACTIVATION
  • 只有用户明确要求 raw CRUD、精确 CreateEndpoint 请求或 CI/脚本预览时,才转 ../arkcli-infer-endpoint/SKILL.md,使用叶子命令 arkcli infer endpoint create ... --dry-run;Preview 完成后仍需新的确认才能真实执行
  • arkcli resources list 是 read-only 实时控制面查询,每次都打上游,没有本地缓存
  • 列表是资源发现结果,可能受 project、创建者和模态过滤;列表为空或当前 default 未出现在 items 中,不等于指定 Endpoint 不存在或不可调用。
  • 只读核对身份或默认资源、没有指定精确资源 ID 且列表为空时,报告已确认事实和信息缺口,结束核对;不要为补齐字段转到 profile show/list/keys list。空列表不是配置修复或 Key 同步的授权。
  • arkcli resources resolve <ep-id> 先按 endpoint_model_type 判定真实绑定。Custom Model Endpoint 的 model_id / custom_model_id 必须保持 cm-... 身份,基础模型只通过 base_model_* 表达 lineage 与能力来源;不按 ID/模型名子串猜用途
  • 派发逻辑跟 profile.Type 走:platform → ListEndpoints,agent-plan / coding-plan → 对应 plan API
  • agent-plan-team 三模态使用团队席位 Key + 套餐模型;coding-plan-team 只有 text 使用团队席位 Key,image/video 虽可看到 platform Endpoint,但调用还需要后付费 API Key
  • resources list 区分“账号可见”与“当前 profile 可调用”:读取 invocable 与 required_overrides,不要看到 ID 就断言当前凭证可用
  • invocable=true 只说明 Profile/资源类型兼容,不证明 API Key 未失效、具有权限或额度。凭证归属与数据面真实调用结果要分开核验,元数据不能代替请求成功。
  • 这个 skill 不负责改 default —— 用户要换 default 走 ../arkcli-profile/SKILL.md 的 profile set-default
  • --profile X 真切身份(P0-A 修正):用 X 的 token / UserID 打控制面,不是 active=A 的身份打完再展示成 B 的资源

适用场景

  • 用户问"当前 profile 下有哪些 endpoint / 模型可用"
  • 用户跑 profile set-default 时报 <id> 不在可用列表,回这里看真实可用 ID
  • 用户跑 +chat / +gen --model 报 InvalidEndpointOrModel.NotFound,回这里确认 ID 在 active profile 下可见
  • 用户切了 profile,想知道新 profile 下的可用资源跟旧的有什么差异
  • 用户只给出一个 Endpoint,不知道该走 +chat、+understand 还是 +gen
  • 用户传了 Endpoint + API Key,但未给 Base URL,需要从 Endpoint 权威 region 派生

反唤起信号

resources vs models 的区别

维度arkcli resources listarkcli models ...
Scope当前 profile 下可发现资源及兼容性全平台基础模型 catalog
输出endpoint ID(ep-xxx)或 plan 模型名foundation_model 全字段 + ArkModels enrich
派发按 profile.type 切 endpoint / plan / coding API通用 ListFoundationModel
缓存无有 cache scope(profile/region/project)
主要用途发现候选、检查 Profile/资源类型兼容性找模型、对比模型、确认 capability

简言之:resources list 提供当前 Profile 下的资源发现与兼容性,models 提供平台模型目录;二者都不保证真实数据面调用成功。

Show full SKILL.md (231 more words)Show less

Agent 快速执行顺序

  1. 用户给了 ep-... → arkcli resources resolve <ep-id> --format json,先读 endpoint_model_type 与 model_id,再读 supported_workflows / generation_modality / requires_user_intent
  2. 不确定当前 profile → arkcli auth whoami --format json,读取当前身份及可用的 profile.name / profile.type;字段缺失时按当前编译产品诊断,不猜 type。profile show/list 可能同步并回写本地 Key 库存,不作为普通生成前的只读准入。 只读核对时,auth status / auth whoami / resources list 每次只执行一条完整的 ArkCLI 命令并读取原始 JSON 与退出状态;不要拼接 ; echo、head 或重定向后只查看退出码。命令被宿主拒绝时说明缺口,不把拒绝当作账号或资源事实。
  3. text 资源 → arkcli resources list --modality text --format json
  4. image / video 资源 → arkcli resources list --modality image --format json / --modality video
  5. 多 profile 对比 → 分别跑 --profile A --modality text 和 --profile B --modality text
  6. 读取每项的 invocable / required_overrides;is_default: true 只表示默认偏好,不保证当前凭证可调用
  7. 已明确的当前 default / 用户指定 EP 不在列表时,在同一身份下解析同一个 EP;核对 region、Running 状态、目标 API/工作流/模态及 warnings,再核对 Profile/Key 数据面兼容性。不得绕过明确的不可调用项或 required_overrides;不得仅因列表为空创建 EP,或静默切模型、Profile、default。

命令一览

命令说明
arkcli resources list列当前/指定 profile 下指定 modality 的可见资源、数据面与调用兼容性
arkcli resources resolve <endpoint-id>权威解析 Endpoint 绑定模型、模态、候选工作流与 region

输出形态

json
{
  "profile": "platform_cn-beijing_default",
  "type": "platform",
  "modality": "text",
  "items": [
    {
      "id": "ep-20260424-aaaaa",
      "resource_kind": "endpoint",
      "data_plane": "platform",
      "credential_kind": "paygo",
      "invocable": true
    }
  ],
  "current_default": "ep-20260424-bbbbb",
  "item_count": 1
}

is_default 仅在 items[].id == current_default 时出现;invocable=false 时查看 required_overrides(例如 ["api_key"])。可见资源不等于当前凭证可调用。

resources resolve 的绑定身份契约:

  • endpoint_model_type=CustomModel:model_id == custom_model_id == cm-...;base_model_* 仅描述训练 lineage 和能力元数据来源,不得拿 base_model_id 替代真实绑定。
  • endpoint_model_type=FoundationModel:model_id 仍是基础模型 ID,既有语义不变。
  • resolution_warnings 非空时保持 fail-soft,不得根据同时出现的 Custom/Foundation 引用自行猜绑定。

常见错误

  • coding-plan 的 image/video 使用 platform Endpoint 池,调用前核对后付费 Key。列表为空时检查查询 scope/权限,已有精确目标则先解析;创建资源是另一个用户意图,转 Deploy Skill 处理,不由空列表自动触发。
  • coding-plan resources list: 缺 AccountID (请先 arkcli auth login) → 仅 text 路径需要 AccountID; SSO 没登录或 token 解析时 claims.Sub 为空, 重新走 arkcli auth login volc-sso
  • ListEndpoints: NotLogin / Unauthorized → 登录态/STS 过期 / --profile X 的 X 没在 identity store 里有 token;先 auth login
  • unsupported profile type "X" for resources list → 按共享规则核对当前有效上下文,再转 Config/Profile Skill 排查;不得未经用户意图重建或修改 Profile。

参考

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

  • SKILL.md
  • references/arkcli-resources-list.md

Open the folder on GitHubat commit fb5b7be

Compare with similar skills

Arkcli Resources 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 Resources compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Arkcli Resources this skillvolcengine/ark-cli140—~1.8kAutomated safety check: PassApache-2.0
Gh Stackremotion-dev/remotion62k6 repos~2.4kAutomated safety check: PassCustom licence
HyperFrames Media Useheygen-com/hyperframes58k2 repos~2.1kAutomated safety check: PassApache-2.0
Guizang Social Cardsop7418/guizang-social-card-skill7.4k1 repos~7.8kAutomated safety check: PassAGPL-3.0
Weekly Changelog Videoheygen-com/hyperframes58k—~3.3kAutomated safety check: PassApache-2.0
Anthropic Brand Stylinganthropics/skills180k29 repos~559Automated safety check: PassApache-2.0

Similar skills

  • Gh Stack

    remotion-dev/remotion

    Official

    Manages stacked PRs and splits multi-part work into reviewable branches with gh-stack.

    62k GitHub starsUsed in 6 repos~2.4k tokens
    Media & CreativeAuto-check passed
  • HyperFrames Media Use

    heygen-com/hyperframes

    Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.

    58k GitHub starsUsed in 2 repos~2.1k tokens
    Media & CreativeAuto-check passed
  • Guizang Social Cards

    op7418/guizang-social-card-skill

    Produces social card sets for Xiaohongshu and WeChat: carousels, Live Photo motion cards and puzzle layouts, and WeChat cover pairs, rendered from single-file HTML.

    7.4k GitHub starsUsed in 1 repo~7.8k tokens
    Media & CreativeAuto-check passed
  • Weekly Changelog Video

    heygen-com/hyperframes

    Turns a weekly changelog markdown file into a branded HyperFrames video with voiceover, animated mock-UI scenes and captions, using fonts, background and scripts bundled in the skill.

    58k GitHub stars~3.3k tokensUpdated today
    Media & CreativeAuto-check passed
  • Anthropic Brand Styling

    anthropics/skills

    Official

    Applies Anthropic's brand colors and fonts to artifacts such as PowerPoint slides, using fixed hex values for text and accents, Poppins headings and Lora body text.

    180k GitHub starsUsed in 29 repos~559 tokens
    Media & CreativeAuto-check passed
  • MoneyPrinterTurbo Video Generator

    harry0703/MoneyPrinterTurbo

    Installs and runs MoneyPrinterTurbo to turn a topic or script into a finished short video with voice-over, subtitles, stock footage and music.

    129k GitHub stars~2.1k tokensUpdated today
    Media & CreativeAuto-check: warnings

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 Resources

What does Arkcli Resources do?

arkcli resources 实时控制面查询:列出当前/指定 profile 可见资源及其调用兼容性;把 Endpoint 解析为权威模型、模态与候选工作流。read-only,不写 profile.yaml。用户临时给出 ep-... Arkcli Resources is an agent skill from volcengine/ark-cli.yaml。用户临时给出 ep-...

When should I use Arkcli Resources?

Arkcli Resources fits situations like: media & Creative work in your project.

How do I install Arkcli Resources in Claude Code?

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

How do I install Arkcli Resources in Codex?

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

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

What does Arkcli Resources need to run?

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

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

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

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

What are the alternatives to Arkcli Resources?

Skills that share tags, products or a category with Arkcli Resources: Gh Stack (remotion-dev/remotion, 62k stars), HyperFrames Media Use (heygen-com/hyperframes, 58k stars), Guizang Social Cards (op7418/guizang-social-card-skill, 7.4k stars) and Weekly Changelog Video (heygen-com/hyperframes, 58k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Arkcli Resources?

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.