bikes

name	bikes
description	Interact with the Pizza Vibe bikes service. Use when the user wants to list bikes, check a bike's status, or reserve a bike for delivery.
argument-hint	[list | get <bikeId> | reserve <bikeId> <user>]

Bikes Service

Interact with the bikes delivery service to list, inspect, and reserve bikes.

Available commands

Determine the action from $ARGUMENTS:

• list — List all bikes and their status
• get <bikeId> — Get the status of a specific bike
• reserve <bikeId> <user> — Reserve a bike for a user

If no arguments are provided, default to list.

How to run

The scripts are located relative to this skill file. Set BIKES_URL from the environment or default to http://localhost:8088.

List all bikes

bash skills/bikes/scripts/list-bikes.sh "${BIKES_URL:-http://localhost:8088}"

Get a specific bike

bash skills/bikes/scripts/get-bike.sh "<bikeId>" "${BIKES_URL:-http://localhost:8088}"

Reserve a bike

bash skills/bikes/scripts/reserve-bike.sh "<bikeId>" "<user>" "${BIKES_URL:-http://localhost:8088}"

Response format

All scripts output JSON from the bikes service. Parse and present the results to the user in a readable format.

Bike fields

Field	Description
id	Bike identifier (e.g. bike-1)
status	AVAILABLE or RESERVED
user	User who reserved the bike (if reserved)
updatedAt	Timestamp of the last status change

Notes

• A bike must be AVAILABLE to be reserved.
• Reserved bikes automatically become AVAILABLE after 10–20 seconds.
• While reserved, the bike emits delivery events to the store service.