provider-integration SKILL.md skillA

provider-integration from hex/claude-council is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add hex/claude-council/provider-integration@git:20261018.9aa258b

Pins git:20261018.9aa258b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
hex/claude-council
Path
skills/provider-integration/SKILL.md
Versions recorded
11
Latest version
git:20261018.9aa258b, committed Oct 18, 2026
First version recorded
Aug 3, 2026
Size
2,623 bytes
Repository stars
892
License
MIT

Adds new AI providers to claude-council, configures provider API settings, troubleshoots provider connections, and documents the provider script interface. Covers creating provider shell scripts, setting API keys, and validating connectivity. Triggers on "add provider", "new AI agent", "provider not working", "API configuration", or "extend council".

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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-flash-latest |
| OpenAI | `OPENAI_API_KEY` | gpt-6-astra |
| Grok | `XAI_API_KEY` (or `GROK_API_KEY`) | grok-latest |
| Perplexity | `PERPLEXITY_API_KEY` | low (Agent API preset) |
| Kimi | `KIMI_API_KEY` | kimi-k3 |
| Ollama | none (local) | first model `ollama list` shows |
| OpenRouter | `OPENROUTER_API_KEY` | anthropic/claude-fable-5.1 (or one seat per `OPENROUTER_MODELS` entry) |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add hex/claude-council/provider-integration@sha256:b6046ceee09fe93a

The line at the top of this page pins the label git:20261018.9aa258b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_cm5j4664cdiatmbw.svg)](https://markdownregistry.com/a/art_cm5j4664cdiatmbw)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 11 versions of this file, between Aug 3, 2026 and Oct 18, 2026, about one every 8 days.

versioncommittedcommitsizeaudit
git:20261018.9aa258b latest2026-10-18 9aa258b 2,623 BA view · diff
git:20261018.de89cee2026-10-18 de89cee 2,620 BA view · diff
git:20261006.f2c03582026-10-06 f2c0358 2,537 BA view · diff
git:20261001.67edf6d2026-10-01 67edf6d 2,376 BA view · diff
git:20260922.17fc9c52026-09-22 17fc9c5 2,193 BA view · diff
git:20260913.f1682cb2026-09-13 f1682cb 2,192 BA view · diff
git:20260903.3b7276f2026-09-03 3b7276f 1,752 BA view · diff
git:20260901.79fd2972026-09-01 79fd297 1,750 BA view · diff
git:20260901.1d6402e2026-09-01 1d6402e 1,706 BA view · diff
git:20260817.013287d2026-08-17 013287d 1,640 BA view · diff
git:20260803.79a6ed12026-08-03 79a6ed1 1,642 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2623 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

hex/claude-council · 892 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_cm5j4664cdiatmbw
GET https://markdownregistry.com/api/v1/resolve?ref=hex/claude-council/provider-integration
GET https://markdownregistry.com/api/v1/blob/b6046ceee09fe93a04460d99f1896c5d05208d7377396bf37359b4c6855f011e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from hex/claude-council

DESIGN.md@mods/council-pane DESIGN.md file
hex/claude-council · mods/council-pane/DESIGN.md
git:20261009.562fe4c · audit A · 892 stars
bug-fixer SKILL.md skill
hex/claude-council · mods/council-pane/specialists/bug-fixer/SKILL.md · A bug reproduces, the expected behaviour is clear, and the fix stands apart from the current work.
git:20260925.093f32a · audit A · 892 stars
ci-fixer SKILL.md skill
hex/claude-council · mods/council-pane/specialists/ci-fixer/SKILL.md · A CI job fails on a named revision and the fix belongs in code, config or tests, not in the CI provider.
git:20260925.093f32a · audit A · 892 stars
docs-updater SKILL.md skill
hex/claude-council · mods/council-pane/specialists/docs-updater/SKILL.md · Docs must be updated or restructured to match code that already changed: README, reference pages, CLI help or config…
git:20260925.093f32a · audit A · 892 stars
refactorer SKILL.md skill
hex/claude-council · mods/council-pane/specialists/refactorer/SKILL.md · A behaviour-preserving restructure is named: extract, rename, move, split a module, or remove duplication across three…
git:20260925.093f32a · audit A · 892 stars
test-pruner SKILL.md skill
hex/claude-council · mods/council-pane/specialists/test-pruner/SKILL.md · Tests in a named area duplicate stronger tests, re-assert the implementation, or keep test-only seams alive, and need…
git:20260925.093f32a · audit A · 892 stars
test-writer SKILL.md skill
hex/claude-council · mods/council-pane/specialists/test-writer/SKILL.md · The task is to add or extend tests for existing behaviour that has a spec, a documented contract, or a confirmed…
git:20260925.093f32a · audit A · 892 stars
council-execution SKILL.md skill
hex/claude-council · skills/council-execution/SKILL.md · Executes council queries by running the query pipeline across selected AI providers (Gemini, OpenAI, Grok, Perplexity)…
git:20261001.67edf6d · audit A · 892 stars
deep-execution SKILL.md skill
hex/claude-council · skills/deep-execution/SKILL.md · Executes agent-enhanced council queries as one Workflow of parallel Claude analyst agents that each query a provider…
git:20260901.5014067 · audit A · 892 stars
local-council-execution SKILL.md skill
hex/claude-council · skills/local-council-execution/SKILL.md · Runs a local council when no external AI providers are configured. Spawns N independent Claude subagents (one per role…
git:20260616.e613527 · audit A · 892 stars

Every file in hex/claude-council

Browse by kind, by grade A, or by owner.