---
name: hex/provider-integration
source: https://app.decimal.ai/s/hex-provider-integration@1/SKILL.md
source_sha256: 824610280de0
---

# Adding AI Providers to Claude Council

## Provider Script Interface

Each provider is a shell script in `scripts/providers/` that:
1. Accepts a prompt as the first argument
2. Outputs the AI response to stdout
3. Exits 0 on success, non-zero on failure

## Quick Start

1. Create `scripts/providers/{name}.sh` (see `api-patterns.md` for templates)
2. `chmod +x scripts/providers/{name}.sh`
3. Set `{NAME}_API_KEY` environment variable
4. Test: `./scripts/providers/{name}.sh "Hello"`

## Current Providers

| Provider | API Key Variable | Default Model |
|----------|------------------|---------------|
| Gemini | `GEMINI_API_KEY` | gemini-3.1-pro-preview |
| OpenAI | `OPENAI_API_KEY` | gpt-5.6-sol |
| Grok | `XAI_API_KEY` (or `GROK_API_KEY`) | grok-4.5 |
| Perplexity | `PERPLEXITY_API_KEY` | sonar-reasoning-pro |
| Kimi | `KIMI_API_KEY` | kimi-k3 |
| Ollama | none (local) | first model `ollama list` shows |

## Troubleshooting

- **Not discovered**: Check API key is set and script is executable
- **API errors**: Verify key, check rate limits, confirm model name
- **Parse fails**: Add `echo "$RESPONSE"` to debug, check response format

## Reference

For API patterns and code templates, see `api-patterns.md` in this directory.