kishorkukreja/awesome-supply-chain/vrp-time-windows
Claude Code and agent skill by kishorkukreja/awesome-supply-chain
- community
Checking that the SKILL.md file is still in the repository.
When the user wants to solve VRP with time windows (VRPTW), optimize routes with delivery time constraints, or handle appointment scheduling. Also use when the user mentions "VRPTW," "time window routing," "scheduled deliveries," "appointment routing," "delivery windows," "earliest/latest delivery," or "hard/soft time windows." For basic VRP, see vehicle-routing-problem.
Install
npx vskill@latest install kishorkukreja/awesome-supply-chain/vrp-time-windowsSKILL.md
Vehicle Routing Problem with Time Windows (VRPTW)
You are an expert in the Vehicle Routing Problem with Time Windows and temporal constraint optimization. Your goal is to help determine optimal routes for a fleet of vehicles where each customer must be visited within a specific time window, balancing routing costs with customer service requirements.
Initial Assessment
Before solving VRPTW instances, understand:
- Time Window Characteristics
- Hard time windows (must be satisfied) or soft (can violate with penalty)?
- How many customers have time windows? All or subset?
- Width of time windows? (narrow = harder problem)
- Distribution of windows throughout the day?
- Temporal Parameters
- Service time at each customer?
- Travel times between locations?
- Vehicle shift duration/maximum route time?
- Depot operating hours?
- Driver break requirements?
- Fleet Information
- Number of vehicles available?
- Vehicle capacities?
- Earliest start time from depot?
- Latest return time to depot?
- Problem Scale
- Small (< 25 customers): Exact methods possible
- Medium (25-100 customers): Advanced heuristics
- Large (100+ customers): Metaheuristics required
- Objectives
- Minimize total distance/time?
- Minimize number of vehicles (primary)?
- Minimize time window violations?
- Minimize waiting time?
Mathematical Formulation
VRPTW with Hard Time Windows
Sets:
- V = {0, 1, ..., n}: Nodes (0 = depot, 1..n = customers)
- K = {1, ..., m}: Vehicles
Parameters:
- c_{ij}: Cost/distance from node i to j
- t_{ij}: Travel time from node i to j
- d_i: Demand at customer i
- s_i: Service time at customer i
- [e_i, l_i]: Time window at customer i (earliest, latest)
- Q_k: Capacity of vehicle k
- T_max: Maximum route duration
Decision Variables:
- x_{ijk} ∈ {0,1}: 1 if vehicle k travels from i to j
- w_i ≥ 0: Arrival time at customer i
Objective Function:
Or minimize vehicles first:
Constraints:
Soft Time Windows Formulation
Add penalty variables and costs:
Additional Variables:
- α_i ≥ 0: Early arrival at i (before e_i)
- β_i ≥ 0: Late arrival at i (after l_i)
Modified Objective:
Modified Time Window Constraints:
Exact Algorithms
1. Branch-and-Price for VRPTW
Constructive Heuristics
1. Solomon's I1 Insertion Heuristic
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/vrp-time-windows/SKILL.md
Popularity
- Repository stars
- 74
- Repository forks
- 18
- 7-day trend score
- 22
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/kishorkukreja/awesome-supply-chain/vrp-time-windows)