math-router

Deterministic router for math cognitive stack - maps user intent to exact CLI commands

422 stars

Best use case

math-router is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Deterministic router for math cognitive stack - maps user intent to exact CLI commands

Teams using math-router should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/math-router/SKILL.md --create-dirs "https://raw.githubusercontent.com/vibeeval/vibecosystem/main/skills/math-router/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/math-router/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How math-router Compares

Feature / Agentmath-routerStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Deterministic router for math cognitive stack - maps user intent to exact CLI commands

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Math Router

**ALWAYS use this router first for math requests.**

Instead of reading individual skill documentation, call the router to get the exact command:

## Usage

```bash
# Route any math intent to get the CLI command
uv run python scripts/cc_math/math_router.py route "<user's math request>"
```

## Example Workflow

1. User says: "integrate sin(x) from 0 to pi"
2. You run: `uv run python scripts/cc_math/math_router.py route "integrate sin(x) from 0 to pi"`
3. Router returns:
   ```json
   {
     "command": "uv run python scripts/cc_math/sympy_compute.py integrate \"sin(x)\" --var x --lower 0 --upper pi",
     "confidence": 0.95
   }
   ```
4. You execute the returned command
5. Return result to user

## Why Use The Router

- **Faster**: No need to read skill docs
- **Deterministic**: Pattern-based, not LLM inference
- **Accurate**: Extracts arguments correctly
- **Complete**: Covers 32 routes across 7 scripts

## Available Routes

| Category | Commands |
|----------|----------|
| sympy | integrate, diff, solve, simplify, limit, det, eigenvalues, inv, expand, factor, series, laplace, fourier |
| pint | convert, check |
| shapely | create, measure, pred, op |
| z3 | prove, sat, optimize |
| scratchpad | verify, explain |
| tutor | hint, steps, generate |
| plot | plot2d, plot3d, latex |

## List All Commands

```bash
# List all available routes
uv run python scripts/cc_math/math_router.py list

# List routes by category
uv run python scripts/cc_math/math_router.py list --category sympy
```

## Fallback

If the router returns `{"command": null}`, the intent wasn't recognized. Then:
1. Ask user to clarify
2. Or use individual skills: /sympy-compute, /z3-solve, /pint-compute, etc.

Related Skills

workflow-router

422
from vibeeval/vibecosystem

Goal-based workflow orchestration - routes tasks to specialist agents based on user goals

tldr-router

422
from vibeeval/vibecosystem

Map code questions to the optimal tldr command by detecting intent and routing to the right analysis layer.

search-router

422
from vibeeval/vibecosystem

Choose the right search tool for each query type

router-first-architecture

422
from vibeeval/vibecosystem

Router-First Architecture

math-progress-monitor

422
from vibeeval/vibecosystem

Metacognitive check-ins during problem solving - detects when to pivot or persist

math-model-selector

422
from vibeeval/vibecosystem

Routes problems to appropriate mathematical frameworks using expert heuristics

math-intuition-builder

422
from vibeeval/vibecosystem

Develops mathematical understanding through examples, visualization, and analogy

math

422
from vibeeval/vibecosystem

Unified math capabilities - computation, solving, and explanation. I route to the right tool.

math-help

422
from vibeeval/vibecosystem

Guide to the math cognitive stack - what tools exist and when to use each

wiring

422
from vibeeval/vibecosystem

Wiring Verification

websocket-patterns

422
from vibeeval/vibecosystem

Connection management, room patterns, reconnection strategies, message buffering, and binary protocol design.

visual-verdict

422
from vibeeval/vibecosystem

Screenshot comparison QA for frontend development. Takes a screenshot of the current implementation, scores it across multiple visual dimensions, and returns a structured PASS/REVISE/FAIL verdict with concrete fixes. Use when implementing UI from a design reference or verifying visual correctness.