research-batch-provider

Researches a new batch provider's API and produces a cited capability matrix with live captures and fixtures.

7|12|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/OpenRouterTeam/docs --skill research-batch-provider-openrouterteam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: research-batch-provider
Source: https://github.com/OpenRouterTeam/docs/tree/main/.agents/skills/research-batch-provider
Command: npx skills add https://github.com/OpenRouterTeam/docs --skill research-batch-provider-openrouterteam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Onboarding a new batch inference provider (e.g. Anthropic, Gemini, xAI) requires exhaustive, evidence-backed knowledge of its API before any adapter code is written. This Skill replaces scattered doc-reading and ad-hoc cURL probing with a structured research phase that produces a single committed note serving as the contract for all downstream implementation and audit work. ## Core Features & Use Cases - Cited capability matrix: Produces a 14-row research note covering auth, endpoints, status models, output/error shapes, limits, retention, pricing, credential shapes, and remote URL support, with every claim backed by an official doc URL or live capture. - Live capture workflow: Runs a canonical capture matrix of batchable-request scenarios (text, tool-calls, reasoning, structured-output, truncated) against the real provider, redacts transcripts, and promotes load-bearing shapes into committed fixtures. - Completion and failure semantics: Answers how the provider signals batch completion, how failed sub-requests appear, and maps each fact to a concrete adapter seam such as pollBatch, parseResult, and parseUsage. - Use Case: Before adding Gemini batch support, run this Skill to generate docs/batch-research/gemini.md with the status mapping, skin reuse decision, fixture plan, and deferred captures, then present it for human sign-off. ## Quick Start Ask the agent to research a new batch provider by name, for example: run the research-batch-provider skill for Anthropic and produce the committed research note with live captures.

Frequently Asked Questions about research-batch-provider

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

FAQPage Schema
How do I research a new batch provider before writing adapter code?▼

Run this research phase to fill a 14-row capability matrix from official docs and live captures, covering auth, endpoints, status models, output shapes, limits, retention, and pricing. The result is a committed note at docs/batch-research/<provider>.md that downstream implementation and audit skills consume directly.

What fixtures does batch provider research produce?▼

It commits real request-plus-response capture pairs per batchable scenario into the provider's adapter fixtures directory, tagged with provenance. Raw transcripts stay uncommitted in /tmp, and doc-derived fixtures are tagged provenance 'docs' until a real capture replaces them.

How are batch status strings mapped to internal statuses?▼

The note must exhaustively list every upstream status string and its mapping, including counter-only providers where lifecycle is derived from durable fields like cancel timestamps. Partially failed jobs map to completed, never failed, and failed lines become result rows carrying an error.

What happens when a live capture is not possible?▼

The capture is deferred, not dropped: the note lists it under a Deferred heading with the reason and unconfirmed field, and fixtures are tagged as doc-derived. Runtime registration is held until real payloads are replayed through pollBatch, parseResult, and parseUsage.

Does the research note decide between reusing a skin and writing a new adapter?▼

Yes, row 10 records the concluded reuse-versus-new decision for skin and adapter, the planned layer list, and the fixture plan. If the provider's sync adapter overrides transformRequest or getReasoningEffort, reuse of the OpenAI batch adapter is forbidden.