PocketCaddie

Use this when a golfer asks how to fix a swing fault, asks for golf drills, or wants something to work on at the driving range or at home. Covers: slice, hook, shanks, hitting it fat or thin, topping, over the top, casting, early release, flipping, chicken wing, early extension, standing up, sway, reverse pivot, hanging back, all arms, rushed tempo, decelerating, tension, blocks, weak strike. Examples: 'how do I fix my slice', 'I come over the top', 'why do I hit it fat', 'drills for my driver', 'what should I practice at the range'. Pass the golfer's own words as query. Returns drill cards from the PocketCaddie library (48 drills with steps, a cue and reps). If the golfer describes a ball flight or contact problem without naming a fault ('my ball curves right', 'I keep hitting the ground first'), use diagnose_ball_flight instead. Don't use it for tee times, course info, equipment prices, distances or rules. Skills: Tempo, Smoothness, Power, Consistency, Transition, Follow-through, Backswing Turn, Follow-Through Turn, Wrist Action, Swing Path, Body Turn, Head Stability, Kinetic Sequence, Hand Speed, Shoulder Turn, X-Factor, Posture.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The golfer's problem or goal in their words."
    },
    "skill": {
      "type": "string",
      "description": "Optional skill name, e.g. Tempo or Backswing Turn."
    },
    "where": {
      "type": "string",
      "enum": [
        "range",
        "home",
        "any"
      ],
      "description": "Where they will practice."
    },
    "max_minutes": {
      "type": "integer",
      "minimum": 5,
      "maximum": 60
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 5
    }
  },
  "additionalProperties": false
}

Use this when the golfer wants the full instructions for one drill: steps, the cue to remember, reps, equipment and why it works. Takes a drill id from search_drills, diagnose_ball_flight or practice_plan.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Use this when a golfer asks for a practice plan, a range routine or a session to do at home, e.g. 'build me a 30-minute range plan', 'what should I do with a bucket of balls', 'home practice for tempo'. Builds a timed plan from PocketCaddie drills for 1–3 skills (map their goal to the closest skills).

{
  "type": "object",
  "properties": {
    "skills": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 3
    },
    "minutes": {
      "type": "integer",
      "minimum": 10,
      "maximum": 90,
      "default": 30
    },
    "where": {
      "type": "string",
      "enum": [
        "range",
        "home",
        "any"
      ],
      "default": "range"
    }
  },
  "required": [
    "skills"
  ],
  "additionalProperties": false
}

Use this when a golfer describes what the ball does or how they hit it, without naming the swing fault: e.g. 'my ball starts left and curves right', 'everything goes right', 'I keep hitting behind the ball', 'I top it', 'I shanked three in a row', 'my shots are weak and short'. Map their words to start direction, curve and contact (leave out what they didn't say). Returns the likely faults from a fixed ball-flight table and the PocketCaddie drills for each, as cards.

{
  "type": "object",
  "properties": {
    "start": {
      "type": "string",
      "enum": [
        "left",
        "straight",
        "right"
      ],
      "description": "Where the ball starts, from the golfer's view."
    },
    "curve": {
      "type": "string",
      "enum": [
        "left",
        "none",
        "right"
      ],
      "description": "Which way it curves in the air."
    },
    "contact": {
      "type": "string",
      "enum": [
        "clean",
        "fat",
        "thin",
        "shank",
        "weak"
      ],
      "description": "fat = ground first, thin = topped or bladed, shank = off the hosel, weak = short with no compression."
    },
    "left_handed": {
      "type": "boolean",
      "default": false
    }
  },
  "additionalProperties": false
}

Use this when someone asks what PocketCaddie is, how it works, what it measures, which phones and watches it supports, what it costs, or whether an iPhone or Apple Watch can track a golf swing without video. Returns PocketCaddie's own description of itself.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}