marketplace_match_engine

Rank drivers for loads using velocity scores with hard filters.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/haulcommand-max/haul-command --skill marketplace-match-engine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: marketplace_match_engine
Source: https://github.com/haulcommand-max/haul-command/tree/main/skills/marketplace_match_engine
Command: npx skills add https://github.com/haulcommand-max/haul-command --skill marketplace-match-engine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Defines the logic for the Velocity Engine to quickly identify the top matches for a load, balancing speed and reliability over price.

Core Features & Use Cases

  • Velocity Score: a weighted composite metric using Proximity, Experience, and Reputation to rank drivers.
  • Binary Gates: enforce filters like Compliance, Equipment readiness, and Insurance/COI validity before scoring.
  • Explainability: outputs a ranked list with explicit reasons for each match to support auditability.
  • Fairness: includes a Rookie Boost for new drivers to help them win early bids.

Quick Start

Provide a load and candidate drivers, then run the marketplace_match_engine to obtain a ranked, explainable list of matches.

Frequently Asked Questions about marketplace_match_engine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I rank drivers for dispatch loads using an automated velocity score?

To rank drivers for dispatch loads, this skill computes a velocity score using proximity, experience, and reputation to identify top matches. It balances speed and reliability over price to return an automated, explainable ranking of drivers.

What is a velocity score in driver dispatch matchmaking?

A velocity score in driver dispatch matchmaking is a weighted composite metric combining driver proximity, experience, and reputation. It optimizes load matching for speed and reliability rather than lowest price, outputting a ranked list of top matches.

How do I enforce hard filters for compliance and COI validity before matching drivers?

You enforce hard filters for compliance and COI validity by applying binary gates before the scoring phase. This ensures equipment readiness and insurance validation are checked, preventing non-compliant drivers from entering the velocity scoring process.

Can I get an explainable top-N driver match ranking for logistics loads?

Yes, you can get an explainable top-N driver match ranking for logistics loads. The engine outputs a ranked list with explicit reasons for each match, supporting auditability and transparency in the automated dispatch selection process.

Does the matchmaking engine include features to help new drivers win early bids?

Yes, the matchmaking engine includes a Rookie Boost feature designed to help new drivers win early bids. This fairness mechanism adjusts the velocity score so new drivers are not penalized for lacking historical reputation data.

What is the best way to match drivers to loads prioritizing speed and reliability over price?

The best way to match drivers to loads prioritizing speed over price is using a velocity-based score. This approach evaluates proximity, experience, and reputation after applying compliance gates, yielding reliable and fast load assignments.