tiagovilasboas

Downshift — AI skill for Claude Code

AI community

Deterministic open-source model router — right-sized LLMs per workload.

How to install Downshift

This entry records only its repository, not the path inside it, so there is no exact command to give. Open tiagovilasboas/downshift and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Downshift does

Deterministic open-source model router — right-sized LLMs per workload. Agent hooks, catalog policy, shadow mode, outcome benchmarks.

Alternatives in AI

  • Agentmemory — #1 Persistent memory for AI coding agents based on real-world benchmarks 1.9k ★
  • Lumenx Model Onboarding — LumenX 模型接入与文档更新流程 - 厂商文档抓取、model_catalog 更新、运行时范围判断、端到端验证 1.2k ★
  • OmniGlyph — Cut your Claude bill 59–70% by rendering bulky LLM context as dense PNG pages — 100% read accuracy, exact per 99 ★

README

Downshift

[![Build](https://github.com/tiagovilasboas/downshift/actions/workflows/ci.yml/badge.svg)](https://github.com/tiagovilasboas/downshift/actions/workflows/ci.yml) [![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE) [![Go 1.27](https://img.shields.io/badge/go-1.27-00ADD8.svg)](https://go.dev) [![Status: beta](https://img.shields.io/badge/status-beta%20%E2%80%94%20practical%20testing-yellow)](https://github.com/tiagovilasboas/downshift/releases)

**Deterministic model routing for AI workloads.**

Downshift classifies each workload, applies catalog policy, and selects model tier and reasoning effort **before execution**—without an LLM in the routing loop. One Go binary: use it as a **coding harness hook** today; the same core is gateway-shaped for tomorrow.

Subagent / request
       ↓
  classify (rules + optional semantic boost)
       ↓
  policy + catalog → tier & model
       ↓
  execute on the chosen model

**Works today with Claude Code, Cursor, Codex, Antigravity, and KiroCrew.** Single binary, no runtime dependencies, no network calls for routing, no API keys to pick a tier.

![Downshift routing](docs/brand/downshift-routing-runtime-light.svg)

**Beta — practical testing phase.** Hooks and adapters are production-minded; harness plans and builds vary in how faithfully they honor `updatedInput.model`. See [Plan compatibility](#plan-compatibility--read-before-installing) before installing.

Why Downshift?

Right-sized models Trivial tasks downshift to small tiers; complex work stays on frontier.
Deterministic Scored signals, not an LLM classifier, on the hot path.
Testable downshift try, outcome benchmarks, optional shadow classifier (DOWNSHIFT_SHADOW_WEIGHTS).
Observable Local telemetry (events.jsonl), feedback with explicit --required-tier for training labels.
Harness-agnostic core Adapters only encode I/O; routing lives in `i