adapt-custom-endpoint

Validates and saves declarative JSON endpoint definitions for submit-then-poll video providers via the ArcReel API.

4.3k|859|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/ArcReel/ArcReel --skill adapt-custom-endpoint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adapt-custom-endpoint
Source: https://github.com/ArcReel/ArcReel/tree/main/agent_runtime_profile/.claude/skills/adapt-custom-endpoint
Command: npx skills add https://github.com/ArcReel/ArcReel --skill adapt-custom-endpoint

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Integrating a new video generation provider into ArcReel requires writing a correct declarative endpoint definition, verifying it against real provider responses, and saving it through the shared server-side validator. Doing this by hand risks schema errors, leaked credentials, and untested billable API calls.

Core Features & Use Cases

  • Definition authoring and validation: Write a minimal JSON definition following the documented format, then iterate with the validate subcommand until errors are empty and warnings are resolved.
  • Response checking and request preview: Run check-response against real submit, poll, and result response samples, and use preview-request to inspect the masked URL, headers, body, and asset summary before any live call.
  • Controlled trial runs and saving: Execute a billable trial-run only after explicit user confirmation, poll with trial-status to a terminal state, then save the definition as a new endpoint or an approved overwrite.
  • Use Case: A user wants to connect a video provider whose API accepts a JSON POST and is polled for task status. The skill guides creating the definition, validating it against the server schema, testing with real responses, and saving it as a reusable custom endpoint.

Quick Start

Ask the agent to adapt a video provider that uses JSON submit-and-poll into an ArcReel custom endpoint, providing the provider's API documentation URL.

Frequently Asked Questions about adapt-custom-endpoint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate a custom video generation provider into ArcReel?

Write a declarative JSON endpoint definition describing the submit and poll requests, then validate it with the custom_endpoint.py validate subcommand. After checking real provider responses and previewing the request, run a confirmed trial and save the definition through the ArcReel API.

What provider API protocols does the custom endpoint definition support?

The definition format supports JSON request/response APIs that follow a submit-then-poll pattern, with optional result fetching. Signature-based authentication, multipart provider requests, and per-asset routing cannot be expressed in the first version of the format.

How do I test a custom endpoint definition without being charged?

Use the validate, check-response, and preview-request subcommands, which run locally against the ArcReel validator without contacting the provider. The trial-run subcommand sends a real billable request and requires explicit user confirmation via --confirm-cost.

Can I store API keys inside the endpoint definition file?

No. Credentials must only appear in auth.headers or auth.query as {{ api_key }} template references, and the workflow prefers referencing an already-saved ArcReel provider via provider_id. API keys must never be written into project files, command arguments, or replies.

Why does my endpoint definition fail validation in ArcReel?

Common causes include schema_version.level not being direct, unresolved warnings, capabilities inconsistent with the assets referenced in submit, or extract JSONPath expressions using unsupported features like recursive descent. Fix the field paths reported by the validate command until errors are empty.