Validate and debug Vercel AI SDK provider configurations including API keys, environment setup, model compatibility, and rate limiting. Use when encountering provider errors, authentication failures, API key issues, missing environment variables, model compatibility problems, rate limiting errors, or when user mentions provider setup, configuration debugging, or SDK connection issues.
View on GitHubFebruary 1, 2026
Select agents to install to:
npx add-skill https://github.com/vanman2024/ai-dev-marketplace/blob/main/plugins/vercel-ai-sdk/skills/provider-config-validator/SKILL.md -a claude-code --skill provider-config-validatorInstallation paths:
.claude/skills/provider-config-validator/# Provider Configuration Validator **Purpose:** Autonomously validate, diagnose, and fix Vercel AI SDK provider configurations. **Activation Triggers:** - API errors (401, 403, 429, 404) - Missing/invalid API keys - Package installation issues - Model compatibility errors - Environment variable problems - Import/connection failures **Key Resources:** - `scripts/validate-provider.sh` - Full validation (packages, keys, env) - `scripts/check-model-compatibility.sh` - Validate model names - `scripts/generate-fix.sh` - Generate fixes for common issues - `scripts/test-provider-connection.sh` - Test real API connection - `examples/troubleshooting-guide.md` - Comprehensive troubleshooting (10+ scenarios) - `templates/` - .env, .gitignore, error handler code templates ## Diagnostic Workflow ### 1. Detect Issue Type Identify error from symptoms: - **401/403**: Invalid API key → Check key format and env var - **429**: Rate limiting → Add retry logic - **404/model_not_found**: Invalid model → Validate model name - **Cannot find module**: Missing package → Install provider SDK - **Missing env var**: No .env → Create .env file - **Import error**: Wrong syntax → Fix imports for framework ### 2. Run Validation Script ```bash # Main validation - checks everything ./scripts/validate-provider.sh <provider> # Examples: ./scripts/validate-provider.sh openai ./scripts/validate-provider.sh anthropic ``` **Checks performed:** - ✅ Provider package installed (correct version) - ✅ Core SDK (`ai`) installed - ✅ .env file exists - ✅ API key set with correct format - ✅ .env in .gitignore (security) ### 3. Validate Model Name (if applicable) ```bash ./scripts/check-model-compatibility.sh <provider> <model> # Examples: ./scripts/check-model-compatibility.sh openai gpt-4o ./scripts/check-model-compatibility.sh anthropic claude-sonnet-4-5-20250929 ``` Shows valid models if name is wrong, suggests closest matches. ### 4. Generate Fixes ```bash ./scripts/generate-fix.sh <issue-type> <p