mcpField
P
provider-health

provider-health

github.com/nyldnAgent workflows4.4k43 installsUpdated 1d ago
Repository

About provider-health

provider-health is a health-check skill for Octopus workflows that summarizes provider availability, authentication, resolved models, and cost categories. It also ranks authentication and version issues and gives corresponding fix commands.

Key features

  1. 01Detect provider availability
  2. 02Summarize auth methods and current models
  3. 03Rank issues and provide fix commands
  4. 04Separate included and billed providers

Use cases

  1. 01Check providers before starting a workflow on a new machine
  2. 02Investigate workflows skipping unavailable providers
  3. 03Review cost categories before a multi-provider workflow

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nyldn/claude-octopus --skill provider-health

After installing, type/provider-healthin Claude Code to confirm it loaded.

Bundled filesagents/openai.yaml

Details

From the project README

Provider Health Check Summary (Starter Pack)

Produce a one-screen health summary of every provider Octopus can seat, so the user knows what a workflow will actually dispatch to before spending money.

When to use

The user asks "what providers do I have?", a workflow banner showed (unavailable - skipping), or a session is starting on a new machine.

Steps

  1. Detect. Run ${CLAUDE_PLUGIN_ROOT}/scripts/helpers/check-providers.sh and ${CLAUDE_PLUGIN_ROOT}/scripts/helpers/check-versions.sh.
  2. Summarize per provider. For each seat report: available or not, auth method (env key, oauth session, subscription), and the model it would resolve to today. Include the claude-sdk seat when CLAUDE_SDK_API_KEY is set (Agent SDK, Opus 5 by default, 1M context). Flag Claude Code older than v2.1.280 for Opus 5.5, older than v2.1.219 for Opus 5, and Codex CLI older than v0.144.0 for GPT-5.6.
  3. Flag problems, ranked. Expired auth first (breaks dispatch), then version drift (behavior skew), then missing optional providers (reduced diversity). One line each with the exact fix command (grok login, opencode auth login, key export).
  4. State the cost posture. Split the roster into included (Claude, agy, copilot, ollama, cursor-agent) versus billed (codex, perplexity, grok, openrouter, atlascloud, claude-sdk) so the user can predict what a multi-provider workflow costs before running it.

Output shape

A single table, one row per provider, columns: Provider, Status, Auth, Model, Cost. Below it, at most three ranked fix-it lines. No prose beyond that.

Guardrails

  • Report only what the detection scripts return this session. A provider that worked yesterday but fails detection now is DOWN; do not soften it.

Comments

Markdown supported