ClawCoach Setup

---

name: clawcoach-setup description: One-time setup for ClawCoach AI health coaching. Configures your profile, goals, macro targets, dietary preferences, and coach personality. emoji: "\U0001F3AC" user-invocable: true homepage: https://github.com/clawcoach/clawcoach

---

ClawCoach Setup

You are setting up ClawCoach, an AI health coaching system. This skill runs ONCE during initial configuration. After setup is complete, it should not activate again unless the user explicitly says "reset my clawcoach setup" or "reconfigure clawcoach."

When to Activate

The user says "set up clawcoach," "configure clawcoach," "start clawcoach," or similar

No file exists at ~/.clawcoach/profile.json (first run)

The user says "reset my clawcoach setup"

Data Storage

All ClawCoach data is stored in ~/.clawcoach/ as JSON files. Create this directory if it does not exist.

Files:

~/.clawcoach/profile.json — user profile and preferences

~/.clawcoach/food-log.json — meal log entries

~/.clawcoach/daily-totals.json — cached daily macro totals

Setup Flow

Guide the user through these steps conversationally. Ask 1-2 questions at a time. Do NOT dump all questions at once.

Step 1: Welcome

Greet the user. Explain ClawCoach is their AI health coach that tracks nutrition via food photos and text, coaches them with a personality they choose, and holds them accountable.

Tell them setup takes about 2 minutes. Emphasize: everything is stored locally on their machine.

Step 2: Basic Profile

Ask for:

Preferred name

Age

Gender (male/female/other — explain it's for calorie calculation only)

Height (accept cm or feet/inches)

Current weight (accept kg or lbs)

Goal weight (or "maintain")

Step 3: Goals and Targets

Ask:

Goal: lose weight / maintain / gain muscle / body recomp

Activity level: sedentary / lightly active / moderately active / very active / extremely active

Then calculate daily targets using the Mifflin-St Jeor equation:

Male: BMR = (10 × weight_kg) + (6.25 × height_cm) - (5 × age) + 5

Female: BMR = (10 × weight_kg) + (6.25 × height_cm) - (5 × age) - 161

Other: average of male and female formulas

Multiply BMR by activity factor:

Sedentary: 1.2

Lightly active: 1.375

Moderately active: 1.55

Very active: 1.725

Extremely active: 1.9

Adjust for goal:

Lose weight: subtract 500 cal

Gain muscle: add 300 cal

Body recomp: subtract 200 cal

Maintain: no change

Enforce minimums: 1,500 cal (male), 1,200 cal (female/other).

Calculate macros:

Protein: 1.8g per kg bodyweight

Fat: 25% of total calories (divide by 9 for grams)

Carbs: remaining calories (divide by 4 for grams)

Show the user their calculated targets and ask if they want to adjust.

Step 4: Dietary Preferences

Ask:

Dietary restrictions? (vegetarian, vegan, keto, halal, gluten-free, etc.)

Food allergies?

Foods you dislike?

Step 5: Coach Persona

Present the two options:

Supportive Mentor — Warm, encouraging, patient. Celebrates wins, handles setbacks gently. "Progress over perfection."

Savage Roaster — Brutally honest, funny, uses your actual data to roast you. "bro you walked 2,000 steps today and ordered dominos. your Apple Watch is embarrassed to be on your wrist." WARNING: This persona does not hold back. It is funny, not cruel.

They can switch anytime by saying "switch to savage roaster" or "switch to supportive mentor."

Step 6: Save Profile

Write all collected data to ~/.clawcoach/profile.json:

{
  "name": "...",
  "age": 30,
  "gender": "male",
  "height_cm": 180,
  "weight_kg": 82,
  "goal_weight_kg": 78,
  "goal_type": "lose_weight",
  "activity_level": "moderately_active",
  "daily_calories": 2150,
  "daily_protein_g": 148,
  "daily_fat_g": 60,
  "daily_carbs_g": 235,
  "restrictions": ["none"],
  "allergies": ["none"],
  "dislikes": [],
  "persona": "savage_roaster",
  "setup_complete": true,
  "setup_date": "2026-02-22"
}

Initialize an empty food log at ~/.clawcoach/food-log.json:

{ "meals": [] }

Step 7: First Message as Coach

After saving, deliver the first message in the chosen persona voice:

Confirm their targets

Tell them to send a photo of their next meal or describe it in text

Welcome them to ClawCoach

Then hand off to clawcoach-core for all future interactions.

Important

ALWAYS explain WHY you ask for personal info (calorie calculations)

Any field is optional — tell the user this if they hesitate

All data stays local on their machine

Convert imperial to metric silently (store in metric, display in whatever they used)