Agent skill

Provider Integration

by hex in hex/claude-council

Adds new AI providers to claude-council, configures provider API settings, troubleshoots provider connections, and documents the provider script interface.

MITAuto-check passedAI & LLM Engineering

Install Provider Integration

skills CLI
$ npx skills add hex/claude-council --skill provider-integration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hex/claude-council provider-integration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hex/claude-council.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/provider-integration .claude/skills/provider-integration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
provider-integration
GitHub stars
848
Token cost
~635 tokens
SKILL.md length
262 words
Files
2
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Adds new AI providers to claude-council, configures provider API settings, troubleshoots provider connections, and documents the provider script interface.

  • Works in 3 steps: Accepts a prompt as the first argument → Outputs the AI response to stdout → Exits 0 on success, non-zero on failure
  • Provider not working
  • SKILL.md covers Provider Script Interface, Quick Start, Current Providers and Troubleshooting, plus 1 more section
  • Calls ollama; needs GEMINI_API_KEY and OPENAI_API_KEY

What it does

Provider Integration is an agent skill from hex/claude-council. 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".

Its SKILL.md is about 640 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `api-patterns.md`).

It sits in AI & LLM Engineering, covering Shell scripting and Model routing and gateways. It works with Kimi, OpenRouter, OpenAI and Perplexity. The repository describes itself as: Claude Code plugin that asks several AI coding agents the same question and shows their answers side by side. Gemini, OpenAI, Grok, Perplexity, Kimi and any model OpenRouter… The licence is MIT.

When your agent uses it

  • Provider not working
  • API configuration

Example prompts

  • “add provider”
  • “new AI agent”
  • “provider not working”
  • “/provider-integration”

Requirements

  • A credential in GEMINI_API_KEY
  • A credential in OPENAI_API_KEY

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Accepts a prompt as the first argument
  2. Outputs the AI response to stdout
  3. Exits 0 on success, non-zero on failure

What it can do on your machine

Read from SKILL.md and the folder at commit 23867e1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • ollama

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GEMINI_API_KEY
    • OPENAI_API_KEY
    • XAI_API_KEY
    • GROK_API_KEY
    • PERPLEXITY_API_KEY
    • KIMI_API_KEY
    • OPENROUTER_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Provider Integration loads about 635 tokens when it runs. Until then it costs about 93 tokens; SKILL.md has 262 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~93
When it runs · the whole SKILL.md, loaded when a task matches
~635

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hex/claude-council at commit 23867e1, republished under its MIT licence (© hex). 262 words, ~635 tokens.

Download SKILL.mdSave it as .claude/skills/provider-integration/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
provider-integration
description
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".

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

ProviderAPI Key VariableDefault Model
GeminiGEMINI_API_KEYgemini-flash-latest
OpenAIOPENAI_API_KEYgpt-6-astra
GrokXAI_API_KEY (or GROK_API_KEY)grok-latest
PerplexityPERPLEXITY_API_KEYsonar-reasoning-pro
KimiKIMI_API_KEYkimi-k3
Ollamanone (local)first model ollama list shows
OpenRouterOPENROUTER_API_KEYanthropic/claude-fable-5.1 (or one seat per OPENROUTER_MODELS entry)

CLI providers (codex, antigravity, grok-cli, kimi-cli, cursor-cli) need no key: they are discovered when their binary is on PATH and use that CLI's own login. claude-cli is the exception: claude is on every user's PATH, so it has no discovery arm and joins only when named in --providers or COUNCIL_PROVIDERS. See scripts/providers/kimi-cli.sh and cursor-cli.sh for the headless-run pattern: a read-only mode, a JSON output format the answer is parsed from, --model only on an explicit *_CLI_MODEL override, and run_with_deadline in place of the API providers' retry. A CLI that times out or fails reports through cli_failure_message in scripts/lib/cli-stderr.sh: the timeout, or the last 500 bytes of the CLI's stderr with colour codes stripped.

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.

© hex, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/provider-integration of hex/claude-council.

  • SKILL.md
  • api-patterns.md

Open the folder on GitHubat commit 23867e1

Compare with similar skills

Provider Integration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Provider Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Provider Integration this skillhex/claude-council848—~635Automated safety check: PassMIT
LLM Modelsmajiayu000/claude-skill-registry6661 repos~992Automated safety check: PassMIT
Proxy Mode ReferenceMadAppGang/claude-code284—~1.3kAutomated safety check: PassMIT
Embeddings via 9Routerdecolua/9router30k—~604Automated safety check: PassMIT
Using Ccproxy Inspectorstarbaser/ccproxy350—~2.7kAutomated safety check: PassCustom licence
Using Ccproxy APIstarbaser/ccproxy350—~4kAutomated safety check: PassCustom licence

Similar skills

  • LLM Models

    majiayu000/claude-skill-registry

    Access Claude, Gemini, Kimi, GLM and 100+ LLMs via inference.sh CLI using OpenRouter.

    666 GitHub starsUsed in 1 repo~992 tokens
    AI & LLM EngineeringAuto-check passed
  • Proxy Mode Reference

    MadAppGang/claude-code

    Reference guide for using external AI models via claudish CLI.

    284 GitHub stars~1.3k tokensUpdated 6 mo ago
    AI & LLM EngineeringAuto-check passed
  • Embeddings via 9Router

    decolua/9router

    Generates vector embeddings through the 9Router /v1/embeddings endpoint, using models from providers such as OpenAI, Gemini, Mistral and Voyage for RAG and semantic search.

    30k GitHub stars~604 tokensUpdated 7 days ago
    AI & LLM EngineeringAuto-check passed
  • Using Ccproxy Inspector

    starbaser/ccproxy

    Operates the ccproxy inspector MITM system for intercepting, inspecting, and transforming LLM API traffic.

    350 GitHub stars~2.7k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Using Ccproxy API

    starbaser/ccproxy

    Guides users through ccproxy as an OpenAI-compatible and Anthropic-compatible LLM API server with SDK integration, OAuth authentication, sentinel key substitution, model routing, and troubleshooting.

    350 GitHub stars~4k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Configuring Vision

    oxbshw/watch-skill

    The user wants to connect an LLM or vision provider, already has an API key, asks "can I use OpenAI/Anthropic/Gemini/OpenRouter", wants local Ollama, or needs different cheap and strong models.

    460 GitHub stars~509 tokensUpdated 23 days ago
    AI & LLM EngineeringAuto-check: notes

More from hex/claude-council

All 10 skills in this repo
  • Local Council Execution

    hex/claude-council

    Runs a local council when no external AI providers are configured.

    848 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed
  • Council Execution

    hex/claude-council

    Executes council queries by running the query pipeline across selected AI providers (Gemini, OpenAI, Grok, Perplexity), displaying formatted responses verbatim, and generating a synthesis of…

    848 GitHub stars~824 tokensUpdated 2 days ago
    Auto-check passed
  • Deep Execution

    hex/claude-council

    Executes agent-enhanced council queries as one Workflow of parallel Claude analyst agents that each query a provider, evaluate response quality, ask follow-up questions, and return a schema-enforced…

    848 GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check passed
  • Bug Fixer

    hex/claude-council

    A bug reproduces, the expected behaviour is clear, and the fix stands apart from the current work.

    848 GitHub stars~991 tokensUpdated 2 days ago
    Auto-check passed
  • CI Fixer

    hex/claude-council

    A CI job fails on a named revision and the fix belongs in code, config or tests, not in the CI provider.

    848 GitHub stars~941 tokensUpdated 2 days ago
    Auto-check passed
  • Docs Updater

    hex/claude-council

    Docs must be updated or restructured to match code that already changed: README, reference pages, CLI help or config docs.

    848 GitHub stars~930 tokensUpdated 2 days ago
    Auto-check passed

Questions about Provider Integration

What does Provider Integration do?

Adds new AI providers to claude-council, configures provider API settings, troubleshoots provider connections, and documents the provider script interface. Provider Integration is an agent skill from hex/claude-council. Adds new AI providers to claude-council, configures provider API settings, troubleshoots provider connections, and documents the provider script interface.

When should I use Provider Integration?

Provider Integration fits situations like: provider not working; API configuration.

How do I install Provider Integration in Claude Code?

Run `npx skills add hex/claude-council --skill provider-integration -a claude-code`. Or copy the skill folder (skills/provider-integration in hex/claude-council) into .claude/skills/provider-integration in your project. Claude Code loads it when a task matches its description.

How do I install Provider Integration in Codex?

Run `npx skills add hex/claude-council --skill provider-integration -a codex`. Or copy the skill folder (skills/provider-integration in hex/claude-council) into .agents/skills/provider-integration in your project. Codex loads it when a task matches its description.

Can I use Provider Integration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hex/claude-council --skill provider-integration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/provider-integration, .gemini/skills/provider-integration, .github/skills/provider-integration and .opencode/skills/provider-integration in your project.

What does Provider Integration need to run?

Going by SKILL.md and its folder, Provider Integration needs the command-line tools its instructions call (ollama) and credentials named GEMINI_API_KEY, OPENAI_API_KEY, XAI_API_KEY and GROK_API_KEY. Our summary lists: A credential in GEMINI_API_KEY; A credential in OPENAI_API_KEY.

Does Provider Integration access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Provider Integration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Provider Integration use?

Provider Integration is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Provider Integration use?

About 635 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Provider Integration?

Skills that share tags, products or a category with Provider Integration: LLM Models (majiayu000/claude-skill-registry, 666 stars), Proxy Mode Reference (MadAppGang/claude-code, 284 stars), Embeddings via 9Router (decolua/9router, 30k stars) and Using Ccproxy Inspector (starbaser/ccproxy, 350 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Provider Integration?

hex (a GitHub user) maintains it in hex/claude-council, which has 848 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 6, 2026.

Source: hex/claude-council on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.