majiayu000 Provider Management Skill
Comprehensive management of AI models across all major providers with multi-auth support and automatic fallback.
Overview
Supports ALL major AI providers and models with three authentication methods:
| Priority | Auth Type | Description |
|---|---|---|
| 100 | Subscription | Pro/Plus/Max subscriptions (highest priority) |
| 50 | OAuth | OAuth 2.0 tokens (Antigravity-style) |
| 10 | API | Direct API keys (lowest priority) |
Supported Models
Claude (Anthropic)
claude-4-opus,claude-sonnet-4,claude-3.5-sonnet,claude-3.5-haiku,claude-3-opus- Providers: anthropic-subscription, anthropic-oauth, anthropic-api, bedrock, vertex, openrouter
GPT (OpenAI)
gpt-4.1,gpt-4.1-mini,gpt-4o,gpt-4o-mini,o1,o3-mini- Providers: openai-subscription, openai-oauth, openai-api, azure, openrouter
Gemini (Google)
gemini-2.5-pro,gemini-2.5-flash,gemini-2.0-flash,gemini-1.5-pro- Providers: google-subscription, google-oauth, google-api, vertex-google, openrouter
Grok (xAI)
grok-3,grok-3-mini- Providers: xai-subscription, xai-api, openrouter
Other Models
- Llama:
llama-4-maverick,llama-3.3-70b(bedrock, together, groq, openrouter) - DeepSeek:
deepseek-r1,deepseek-v3(deepseek-api, together, openrouter) - Mistral:
mistral-large,codestral(mistral-api, bedrock, azure, openrouter) - Cohere:
command-r-plus(cohere-api, bedrock, openrouter) - Qwen:
qwen-2.5-72b(together, openrouter)
Provider-Specific Model IDs
| Canonical | anthropic-api | bedrock | vertex | openrouter |
|---|---|---|---|---|
| claude-sonnet-4 | claude-sonnet-4-20250514 | anthropic.claude-sonnet-4-20250514-v1:0 | claude-sonnet-4@20250514 | anthropic/claude-sonnet-4 |
| gpt-4o | gpt-4o-2024-11-20 | - | - | openai/gpt-4o |
| gemini-2.5-pro | - | - | gemini-2.5-pro-preview-05-06 | google/gemini-2.5-pro-preview |
Available Commands
/provider-auth
Configure authentication for providers.
# View all auth status
/provider-auth status
# Set API key
/provider-auth setup anthropic-api --key sk-ant-...
# Start OAuth flow (Antigravity-style)
/provider-auth oauth google-oauth
# Set subscription token
/provider-auth setup anthropic-subscription --key <session-token>
/provider-models
List models and provider mappings.
# List all models
/provider-models list
# Filter by family
/provider-models list --filter claude
# Get model info with all provider IDs
/provider-models info claude-sonnet-4
# Filter by capability
/provider-models capability reasoning
/provider-priority
Manage provider order.
/provider-priority
/provider-priority set anthropic-subscription,anthropic-api,bedrock
/provider-priority move bedrock 1
/provider-limits
Configure usage limits.
/provider-limits
/provider-limits anthropic-api --daily 1M --monthly 10M
/provider-status
View usage dashboard.
/provider-status
/provider-status bedrock
/provider-status --reset
/provider-switch
Manual control.
/provider-switch bedrock
/provider-switch --auto on
Configuration Files
~/.opencode/provider-fallback/
├── config.json # Priority, limits, settings
├── usage.json # Usage tracking
├── auth.json # Stored credentials (0600 permissions)
└── tokens.json # OAuth tokens
Authentication Priority Flow
1. Request comes in for model (e.g., claude-sonnet-4)
2. Get all configured providers for that model's vendor
3. Sort by auth priority: subscription (100) > oauth (50) > api (10)
4. Filter by usage capacity
5. Select best available provider
6. Get provider-specific model ID
7. Make request with appropriate credentials
OAuth Setup (Antigravity-style)
For Google, Anthropic, or OpenAI OAuth:
# 1. Start OAuth flow
/provider-auth oauth google-oauth
# 2. Enter client ID and secret when prompted
# 3. Browser opens for authorization
# 4. Callback server receives token
# 5. Tokens stored securely
OAuth tokens auto-refresh when within 60 seconds of expiry.
Best Practices
Prioritize Subscriptions
- Configure subscription auth first (highest priority, often includes extra features)
- Add OAuth as secondary (good for personal accounts)
- Use API keys as fallback
Multi-Vendor Setup
# Configure multiple vendors
/provider-auth setup anthropic-subscription --key <token>
/provider-auth setup openai-api --key sk-...
/provider-auth setup google-api --key AIza...
# System auto-selects best for each model family
For Reliability
- Configure 2-3 auth methods per vendor
- Set conservative limits (80% of actual)
- Keep auto-switch enabled
- OAuth tokens refresh automatically
Troubleshooting
OAuth Token Expired
Tokens refresh automatically. If manual refresh needed:
/provider-auth refresh google-oauth
Subscription Not Detected
Ensure session token is valid and not expired:
/provider-auth setup anthropic-subscription --key <new-token>
Wrong Auth Method Used
Check configured providers and priorities:
/provider-auth status
The system always prefers: subscription > oauth > api