I Built a Skill So Claude Automatically Routes Tasks to Free-Tier AI Providers

2026-03-27

4 min read

by Lakshmi Sravya Vedantham

Receive daily AI-curated summaries of engineering articles from top tech companies worldwide.

This article introduces agent-hub, a Claude Code skill that automatically classifies tasks and routes them to the best free-tier AI provider.

•Tasks are classified into five types (code, research, creative, fast, general) and routed to Codex, Gemini, MiniMax, or Groq accordingly
•router.py checks token budgets in usage.json before each API call and applies auto-fallback when a provider drops below 10% of its free tier
•A live status bar at the start of every response shows real-time usage counts and color-coded health indicators for all four providers
•Hard stops prevent silent failures: if both primary and fallback providers are exhausted, the router surfaces the issue to the user
•The implementation is ~530 lines of Python 3.8+, uses only requests and python-dotenv, includes 61 tests, and stores API keys in ~/.claude/agent-hub/.env with chmod 600

Related Articles