add-provider-monitor

Creates provider monitor configs with Zod schemas and registers them in the monitors index.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding a new AI provider monitor to the OpenRouter codebase requires touching multiple files with consistent patterns — schema definitions, StandardMonitor instantiation, auth headers, and index registration. This Skill provides a step-by-step checklist with ready-to-use templates so nothing is missed. ## Core Features & Use Cases - Three config templates: Covers simple public endpoints, API-key-authenticated providers, and providers with non-standard response shapes. - Schema guidance: Shows how to extend StandardModelDataSchema with provider-specific fields and normalize values like hf_slug, max_completion_tokens, and supported_sampling_parameters. - Registration checklist: Walks through updating the all-monitors index, adding API key env vars, and optionally creating vendor tests. - Use Case: When onboarding a new inference provider like NextBit or IO.net, follow this Skill to create the monitor config, wire up authentication, and register it in getProviderMonitors(). ## Quick Start Add a provider monitor for the provider named X with model listing API at its /v1/models endpoint, using the appropriate template for its auth and response shape.

Frequently Asked Questions about add-provider-monitor

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

FAQPage Schema
How do I add a new provider monitor in OpenRouter?▼

Create a config file in packages/provider-monitors/configs/<dir-name>/index.ts using a StandardMonitor template, define a Zod schema extending StandardModelDataSchema, then register the monitor in configs/all/index.ts inside getProviderMonitors().

How do I handle a provider API that requires an API key?▼

Use the auth template with getHeaderMap calling getAuthorizationHeaders, reading the key from the environment. Add the key as an UPPER_SNAKE_CASE_PROVIDER_API_KEY entry in the ProvidersEnv type at packages/providers/env.ts.

What if the provider API does not return a standard data array?▼

Pass a custom responseSchema to StandardMonitor that parses the provider's response shape and transforms it into the standard { data: [...] } format, for example mapping a models field to data.

Does StandardMonitor normalize Hugging Face slugs automatically?▼

StandardMonitor resolves hf_slug from hugging_face_id automatically at build time. You only need manual normalization in the transform when the provider returns a hugging_face_url instead of an ID.

When should I add a vendor.test.ts file for a monitor?▼

Add vendor.test.ts when the provider has specific response shapes worth validating. It is optional, and existing examples like nextbit and io-net show the expected testing pattern.