Workout Generator Skill

Generate a personalized 3-workout program (Push/Pull/Legs, 6 exercises each) powered by an AI fitness coach. The coach designs evidence-based programs with progressive overload, compound-first exercise ordering, and rep ranges tailored to your goals.

Payment (x402 Protocol)

This skill uses the x402 payment protocol. This is NOT a normal payment — do NOT broadcast a transaction on-chain yourself.

Cost: 0.01 USDC on Solana (mainnet)
Facilitator: https://facilitator.corbits.dev

CRITICAL: How x402 Payment Works

x402 is a header-based payment protocol. The server handles settlement. You must follow this exact flow:

POST to the endpoint — you will receive HTTP 402 Payment Required
The 402 response body contains payment requirements (amount, recipient, asset, network)
Sign a Solana transaction for the required USDC amount — but DO NOT broadcast it
Base64-encode the signed transaction and attach it as the X-PAYMENT header
Retry the same POST request with the X-PAYMENT header included
The server's facilitator verifies the signed transaction, broadcasts it on-chain, and returns the workout data

DO NOT send money directly to the recipient wallet. The facilitator must be the one to broadcast the transaction. If you broadcast it yourself, the server will never see your payment proof and you will lose your funds without receiving data.

x402 Request Flow

# Step 1: Initial request (gets 402)
POST https://workout-rho-eight.vercel.app/api/agent/generate-workouts
Content-Type: application/json

{"userPreferences": "Full gym, hypertrophy, intermediate"}

# Response: HTTP 402 with JSON body containing payment requirements

# Step 2: Sign transaction (DO NOT BROADCAST), then retry with header
POST https://workout-rho-eight.vercel.app/api/agent/generate-workouts
Content-Type: application/json
X-PAYMENT: <base64-encoded-signed-transaction>

{"userPreferences": "Full gym, hypertrophy, intermediate"}

# Response: HTTP 200 with workout data

Endpoint

POST https://workout-rho-eight.vercel.app/api/agent/generate-workouts
Content-Type: application/json

{
  "userPreferences": "Equipment: Full gym. Goals: Hypertrophy. Experience: Intermediate. No shoulder injuries."
}

Response

{
  "workouts": [
    {
      "type": "Push",
      "exercises": ["Flat Barbell Bench Press", "Incline Dumbbell Press", "Overhead Press", "Cable Flyes", "Lateral Raises", "Tricep Pushdowns"]
    },
    {
      "type": "Pull",
      "exercises": ["Barbell Rows", "Weighted Pull-ups", "Cable Rows", "Face Pulls", "Barbell Curls", "Hammer Curls"]
    },
    {
      "type": "Legs",
      "exercises": ["Barbell Back Squats", "Romanian Deadlifts", "Leg Press", "Walking Lunges", "Leg Curls", "Calf Raises"]
    }
  ]
}

Preferences Guide

The userPreferences field is free-text. Include any of the following for better results:

Equipment: Gym, home, dumbbells only, bodyweight
Goals: Strength, hypertrophy, endurance, general fitness
Experience: Beginner, intermediate, advanced
Injuries/limitations: Any joints or movements to avoid
Training style: Powerlifting, bodybuilding, functional, athletic

Error Handling

Wallet not configured — prompt the user to set up lobster.cash before proceeding
Not enough balance — inform the user they need at least 0.01 USDC and ask them to fund their lobster.cash wallet
Payment failure — display a clear error message and allow the user to retry
Generation failure (500) — the AI coach occasionally fails; retry the request (payment is only settled on success)

Discovery

Skill metadata is available at:

GET https://workout-rho-eight.vercel.app/api/skill-manifest

Returns pricing, endpoint details, and facilitator information as JSON.

workout-generator