Agent skill

Adapt Custom Endpoint

by ArcReel in ArcReel/ArcReel

当用户要求把采用 JSON 提交后轮询协议的视频或图片供应商接入 ArcReel,或要求编写、验证、测试、保存自定义调用端点定义时使用。

AGPL-3.0Auto-check passedMedia & Creative

Install Adapt Custom Endpoint

skills CLI
$ npx skills add ArcReel/ArcReel --skill adapt-custom-endpoint -a claude-code

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

GitHub CLI
$ gh skill install ArcReel/ArcReel adapt-custom-endpoint --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/ArcReel/ArcReel.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agent_runtime_profile/.claude/skills/adapt-custom-endpoint .claude/skills/adapt-custom-endpoint && 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
adapt-custom-endpoint
GitHub stars
5.4k
Token cost
~413 tokens
SKILL.md length
123 words
Files
3 (incl. scripts, references)
Skills in repo
18
Repo updated
First seen
Licence
AGPL-3.0

At a glance

当用户要求把采用 JSON 提交后轮询协议的视频或图片供应商接入 ArcReel,或要求编写、验证、测试、保存自定义调用端点定义时使用。

  • Works in 7 steps: 读取用户提供的供应商文档 URL;无法读取时请用户粘贴提交、查询任务与响应示例。 → 需要编写或修正定义时读取定义格式,在工作目录创建定义 JSON、 → 运行当前 skill 目录下的… → …
  • Tasks that involve AI video generation
  • SKILL.md covers 工作流 and 连接
  • Runs Python scripts from its folder; needs ARCREEL_API_TOKEN

What it does

Adapt Custom Endpoint is an agent skill from ArcReel/ArcReel. 当用户要求把采用 JSON 提交后轮询协议的视频或图片供应商接入 ArcReel,或要求编写、验证、测试、保存自定义调用端点定义时使用。

Its SKILL.md is about 410 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts and reference files (for example `references/definition-format.md` and `scripts/custom_endpoint.py`).

It sits in Media & Creative, covering AI video generation. The repository describes itself as: AI Agent 驱动的开源可自部署视频工作台:将小说与剧本转为角色、场景、道具资产、分镜、视频和剪映草稿,支持跨镜头一致性、多供应商与费用追踪 | Self-hosted AI video workspace for stories, storyboards and short-form video production. The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve AI video generation

Example prompts

  • “/adapt-custom-endpoint”

Requirements

  • Python 3
  • A credential in ARCREEL_API_TOKEN

Workflow steps

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

  1. 读取用户提供的供应商文档 URL;无法读取时请用户粘贴提交、查询任务与响应示例。
  2. 需要编写或修正定义时读取定义格式,在工作目录创建定义 JSON、
  3. 运行当前 skill 目录下的 scripts/custom_endpoint.py,用 validate 子命令校验。
  4. 对供应商的提交与轮询响应分别运行 check-response;定义包含 result 时也检查取件响应。
  5. 运行 preview-request,核对 URL、method、打码后的 headers、body 与素材摘要。定义有必需素材时,
  6. 测试连接会真实请求供应商并可能计费。调用前必须回问用户。 获得明确同意后才运行
  7. 再次 validate。没有同血统端点时用 save 新建;有重复时默认另存副本并告知用户。

What it can do on your machine

Read from SKILL.md and the folder at commit 08ab3b3. 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 1 file in scripts/ (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 these keys or tokens, usually read from environment variables:

    • ARCREEL_API_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Adapt Custom Endpoint loads about 413 tokens when it runs, and up to ~1.5k if it reads all its reference files. Until then it costs about 23 tokens; SKILL.md has 123 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from ArcReel/ArcReel at commit 08ab3b3, republished under its AGPL-3.0 licence (© ArcReel). 123 words, ~413 tokens.

Download SKILL.mdSave it as .claude/skills/adapt-custom-endpoint/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
adapt-custom-endpoint
description
当用户要求把采用 JSON 提交后轮询协议的视频或图片供应商接入 ArcReel,或要求编写、验证、测试、保存自定义调用端点定义时使用。

适配自定义调用端点

使用随 skill 提供的 scripts/custom_endpoint.py 调用 ArcReel HTTP API;共享 validator 和 API 是验证与保存定义的唯一入口。

工作流

  1. 读取用户提供的供应商文档 URL;无法读取时请用户粘贴提交、查询任务与响应示例。 确认协议属于 JSON 请求/响应的「提交后轮询」形态。签名鉴权、multipart 请求或按素材切换路由 无法由首期定义表达,直接说明缺口。
  2. 需要编写或修正定义时读取定义格式,在工作目录创建定义 JSON、 测试参数 JSON,以及供应商提供的真实响应样本。凭证优先引用 ArcReel 已保存的自定义供应商 provider_id;不得把 API Key 写入项目文件、命令参数或回复。
  3. 运行当前 skill 目录下的 scripts/custom_endpoint.py,用 validate <definition.json> 子命令校验。 修正到 errors 为空。schema_version.level 非 direct 或仍有 warnings 时,修正或向用户说明接受的原因和影响;用 hints 准备测试所需的接口地址和模型。
  4. 对供应商的提交与轮询响应分别运行 check-response;定义包含 result 时也检查取件响应。
  5. 运行 preview-request,核对 URL、method、打码后的 headers、body 与素材摘要。定义有必需素材时, 用 --start-image / --end-image / --reference-images / --reference-audio-files 附上对应文件。
  6. 测试连接会真实请求供应商并可能计费。调用前必须回问用户。 获得明确同意后才运行 trial-run ... --confirm-cost(沿用预览时的素材参数),再用 trial-status <run-id> 查询到终态, 并转述请求、响应、取值与错误。状态为 succeeded 时继续;其他终态停止,只有用户明确要求保存未验证定义时才继续。
  7. 再次 validate。没有同血统端点时用 save 新建;有重复时默认另存副本并告知用户。 只有覆盖既有端点必须回问用户;明确同意后才用 save ... --endpoint-id <id> --confirm-overwrite。保存成功以返回 ce-<id> 为完成判据。

连接

在当前工作区根目录运行脚本。脚本读取 setup-arcreel-skills 创建的 .arcreel/settings.json,从 mcp_url 派生同实例的 /api/v1 地址,并用 api_key 鉴权;配置缺失或无效时先执行 setup skill, 不回退到 localhost。

设置 ARCREEL_EMBEDDED_AGENT=1 时,脚本优先使用 ARCREEL_API_BASE 与 ARCREEL_API_TOKEN;该 JWT 有效期 15 分钟且不续期,API 调用返回 401 时告知用户重开会话获取新 token。 AUTH_ENABLED=false 的本地部署可留空 token。

© ArcReel, AGPL-3.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 2 other files (scripts, references) in agent_runtime_profile/.claude/skills/adapt-custom-endpoint of ArcReel/ArcReel.

  • SKILL.md
  • references/definition-format.md
  • scripts/custom_endpoint.py

Open the folder on GitHubat commit 08ab3b3

Compare with similar skills

Adapt Custom Endpoint 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.

Adapt Custom Endpoint compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Adapt Custom Endpoint this skillArcReel/ArcReel5.4k—~413Automated safety check: PassAGPL-3.0
Video Generationbytedance/deer-flow84k3 repos~1.4kAutomated safety check: PassMIT
Video Cover Imageitwanger/toBeBetterJavaer18k—~3.3kAutomated safety check: PassNone
Seedancesongguoxs/seedance-prompt-skill2.9k1 repos~2.5kAutomated safety check: PassNone
HyperFrames Video Entry Pointheygen-com/hyperframes59k3 repos~5.2kAutomated safety check: PassApache-2.0
Lanshu Create AI Presenter Videocclank/lanshu-create-ai-presenter-video2.6k—~3.6kAutomated safety check: PassMIT

Similar skills

  • Video Generation

    bytedance/deer-flow

    Generates short videos from a structured JSON prompt, optionally guided by a reference image used as the first or last frame.

    84k GitHub starsUsed in 3 repos~1.4k tokens
    Media & CreativeAuto-check passed
  • Video Cover Image

    itwanger/toBeBetterJavaer

    Generate matched 3:4, 16:9, and 4:3 short-video cover images from toBeBetterJavaer video scripts or AI/Java technical topics.

    18k GitHub stars~3.3k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Seedance

    songguoxs/seedance-prompt-skill

    This skill should be used when the user asks to "generate video prompts", "create Seedance prompts", "write video descriptions", mentions "Seedance", "seedance", "即梦", "即梦平台", "视频提示词", "视频生成"…

    2.9k GitHub starsUsed in 1 repo~2.5k tokens
    Media & CreativeAuto-check passed
  • HyperFrames Video Entry Point

    heygen-com/hyperframes

    Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.

    59k GitHub starsUsed in 3 repos~5.2k tokens
    Media & CreativeAuto-check passed
  • Lanshu Create AI Presenter Video

    cclank/lanshu-create-ai-presenter-video

    Turn a topic or finished script into a complete, publish-ready explainer video — led by an AI presenter from an authorized adult presenter image, or performed in one of nine visual explainer styles…

    2.6k GitHub stars~3.6k tokensUpdated 3 days ago
    Media & CreativeAuto-check passed
  • Video Shots

    eternityspring/reelbench-skills

    拉片:把一条成片拆成逐镜头的分析表——每个镜头的时长、景别、类别、运镜、画面. An agent skill from eternityspring/reelbench-skills.

    872 GitHub starsUsed in 1 repo~1.8k tokens
    Media & CreativeAuto-check: notes

More from ArcReel/ArcReel

All 18 skills in this repo
  • PR AI Review Loop

    ArcReel/ArcReel

    PR AI review 收敛。用户或 team-lead 要求启动或继续审查—修复循环时使用;供本地实现者或受委派的 review-looper 调用,不用于 GitHub reviewer 产出审查意见或仅处理单条评论。

    5.4k GitHub stars~667 tokensUpdated today
    Auto-check passed
  • Tech Doc Style Chinese

    ArcReel/ArcReel

    在撰写、改写、校对或审阅中文技术文档、产品文案、界面文案、Markdown 文档、API 说明、操作手册、故障排查或运维文档时使用。采用克制、准确、可扫读的中文技术写作风格;保留原文事实、限制和机器可读内容;按任务读取术语排版、API 状态文案、项目覆盖或受控中文技术写作参考。

    5.4k GitHub starsUsed in 1 repo~845 tokens
    Auto-check passed
  • Translate Docs

    ArcReel/ArcReel

    Translate every dirty ArcReel documentation source into English and refresh the translation lockfile.

    5.4k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Afk Team Workflow

    ArcReel/ArcReel

    把一个 Spec 的全部子 issue(或一组显式 issue)组建团队无人值守跑到全部合并或明确暂停. An agent skill from ArcReel/ArcReel.

    5.4k GitHub stars~794 tokensUpdated today
    Auto-check passed
  • Update Docs

    ArcReel/ArcReel

    根据最近的 git 改动,更新面向用户的文档(README 双语、入门教程、部署、剪映导出等)。手动调用. An agent skill from ArcReel/ArcReel.

    5.4k GitHub stars~544 tokensUpdated today
    Auto-check: notes
  • Generate Script

    ArcReel/ArcReel

    提示词编写:调用项目配置的文本模型,为正式脚本中待编写的分镜 / 视频单元补出 imageprompt 与 videoprompt(参考生视频改写单元正文);ad 项目尚无正式脚本时整份生成。由 create-episode-script 子智能体调用,输入是正式脚本自身的内容与 project.json。

    5.4k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Questions about Adapt Custom Endpoint

What does Adapt Custom Endpoint do?

当用户要求把采用 JSON 提交后轮询协议的视频或图片供应商接入 ArcReel,或要求编写、验证、测试、保存自定义调用端点定义时使用。. Adapt Custom Endpoint is an agent skill from ArcReel/ArcReel.

When should I use Adapt Custom Endpoint?

Adapt Custom Endpoint fits situations like: tasks that involve AI video generation.

How do I install Adapt Custom Endpoint in Claude Code?

Run `npx skills add ArcReel/ArcReel --skill adapt-custom-endpoint -a claude-code`. Or copy the skill folder (agent_runtime_profile/.claude/skills/adapt-custom-endpoint in ArcReel/ArcReel) into .claude/skills/adapt-custom-endpoint in your project. Claude Code loads it when a task matches its description.

How do I install Adapt Custom Endpoint in Codex?

Run `npx skills add ArcReel/ArcReel --skill adapt-custom-endpoint -a codex`. Or copy the skill folder (agent_runtime_profile/.claude/skills/adapt-custom-endpoint in ArcReel/ArcReel) into .agents/skills/adapt-custom-endpoint in your project. Codex loads it when a task matches its description.

Can I use Adapt Custom Endpoint 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 ArcReel/ArcReel --skill adapt-custom-endpoint -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/adapt-custom-endpoint, .gemini/skills/adapt-custom-endpoint, .github/skills/adapt-custom-endpoint and .opencode/skills/adapt-custom-endpoint in your project.

What does Adapt Custom Endpoint need to run?

Going by SKILL.md and its folder, Adapt Custom Endpoint needs Python for the scripts in its folder and credentials named ARCREEL_API_TOKEN. Our summary lists: Python 3; A credential in ARCREEL_API_TOKEN.

Does Adapt Custom Endpoint 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 Adapt Custom Endpoint 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Adapt Custom Endpoint use?

Adapt Custom Endpoint is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Adapt Custom Endpoint use?

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

What are the alternatives to Adapt Custom Endpoint?

Skills that share tags, products or a category with Adapt Custom Endpoint: Video Generation (bytedance/deer-flow, 84k stars), Video Cover Image (itwanger/toBeBetterJavaer, 18k stars), Seedance (songguoxs/seedance-prompt-skill, 2.9k stars) and HyperFrames Video Entry Point (heygen-com/hyperframes, 59k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Adapt Custom Endpoint?

ArcReel (a GitHub organization) maintains it in ArcReel/ArcReel, which has 5,399 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 9, 2026.

Source: ArcReel/ArcReel on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.