OpenRouter Config Validator

Comprehensive validation and testing utilities for OpenRouter API configuration, model availability, routing setup, and cost monitoring.

What This Skill Provides

• API Key Validation: Format checking and connectivity testing

• Model Availability Checking: Verify requested models are accessible

• Routing Configuration Testing: Validate model routing and fallback chains

• Environment Validation: Check .env file completeness and correctness

• Fallback Testing: Test fallback chain execution and behavior

• Provider Status Checking: Monitor provider availability and health

• Usage Analysis: Track API usage patterns and cost optimization

• Troubleshooting: Comprehensive diagnostic tools for common issues

Instructions

Phase 1: Identify Validation Need

Determine what needs validation:

• API key format and connectivity

• Model availability and access

• Routing configuration correctness

• Environment variable completeness

• Fallback chain behavior

• Provider health status

• Usage patterns and costs

• General troubleshooting

Phase 2: Run Appropriate Validation Script

Execute the relevant validation script from scripts/ directory:

API Key Validation:

bash scripts/validate-api-key.sh <api-key>

Model Availability Check:

bash scripts/check-model-availability.sh <model-id>

Routing Configuration Test:

bash scripts/test-routing.sh <config-file>

Environment Validation:

bash scripts/validate-env-config.sh <env-file>

Fallback Chain Testing:

bash scripts/test-fallback.sh <fallback-config>

Provider Status Check:

bash scripts/check-provider-status.sh <provider-name>

Usage Analysis:

bash scripts/analyze-usage.sh <date-range>

Comprehensive Troubleshooting:

bash scripts/troubleshoot.sh

Phase 3: Load Appropriate Template

Use templates from templates/ directory for configuration:

Environment Setup:

• templates/.env.template

• Complete configuration template

• templates/.env.example

• Minimal configuration example

Monitoring Configuration:

• templates/monitoring-config.json

• X-Title and HTTP-Referer setup

• templates/budget-alerts.json

• Cost alert configuration

Provider Preferences:

• templates/provider-preferences.json
• Provider routing preferences

Phase 4: Reference Troubleshooting Examples

Check examples/ directory for common issue resolutions:

• examples/api-key-troubleshooting.md

• API key issues

• examples/model-not-found.md

• Model availability problems

• examples/rate-limiting.md

• Rate limit handling

• examples/fallback-issues.md

• Fallback chain debugging

• examples/cost-optimization.md

• Cost reduction strategies

• examples/provider-errors.md

• Provider-specific errors

Phase 5: Report Results

Summarize validation results:

• What was tested

• Issues found (if any)

• Recommended fixes

• Next steps

When Agents Should Use This Skill

Automatic triggers:

• Setting up new OpenRouter integration

• Debugging API connection failures

• Validating configuration before deployment

• Troubleshooting model access issues

• Analyzing unexpected API costs

• Testing fallback chain behavior

• Monitoring provider health

User-requested scenarios:

• "Validate my OpenRouter configuration"

• "Test if model X is available"

• "Why is my fallback chain not working?"

• "Check my API usage costs"

• "Troubleshoot OpenRouter connection"

• "Verify my routing configuration"

Validation Capabilities

API Key Validation

• Format checking (sk-or-v1-* pattern)

• Connectivity testing via /auth/key endpoint

• Permission verification

• Credit balance checking

Model Availability

• Model ID existence verification

• Provider availability checking

• Access permission validation

• Alternative model suggestions

Configuration Testing

• .env file completeness

• Required variable presence

• Format validation

• Value sanity checks

Routing Validation

• Model routing configuration

• Fallback chain structure

• Provider preference validation

• Cost optimization checks

Usage Analysis

• Request volume tracking

• Cost breakdowns by model

• Provider distribution

• Rate limit monitoring

• Budget alert configuration

Script Reference

All scripts located in skills/openrouter-config-validator/scripts/ :

• validate-api-key.sh

• API key format and connectivity

• check-model-availability.sh

• Model access verification

• test-routing.sh

• Routing configuration testing

• validate-env-config.sh

• Environment validation

• test-fallback.sh

• Fallback chain testing

• check-provider-status.sh

• Provider health monitoring

• analyze-usage.sh

• Usage pattern analysis

• troubleshoot.sh

• Comprehensive diagnostics

Template Reference

All templates located in skills/openrouter-config-validator/templates/ :

• .env.template

• Complete environment configuration

• .env.example

• Minimal configuration example

• monitoring-config.json

• Request monitoring setup

• budget-alerts.json

• Cost alert configuration

• provider-preferences.json

• Provider routing preferences

Example Reference

All examples located in skills/openrouter-config-validator/examples/ :

• api-key-troubleshooting.md

• Common API key issues

• model-not-found.md

• Model availability solutions

• rate-limiting.md

• Rate limit handling strategies

• fallback-issues.md

• Fallback debugging guide

• cost-optimization.md

• Cost reduction techniques

• provider-errors.md

• Provider-specific error handling

Requirements

• bash 4.0+

• curl (for API testing)

• jq (for JSON parsing)

• OpenRouter API key (for live testing)

• Internet connectivity (for API calls)

Skill Location: plugins/openrouter/skills/openrouter-config-validator/ Version: 1.0.0