habit-ai_skill

Overview

This skill connects to the Habit AI API to track meals, water, weight, steps, meditation, and journal entries. It enables logging nutrition with precise ingredient-level data, uploading food photos, and using AI coaches for eating and mindfulness. Requires a Habit AI account and an API key starting with hab_ to authenticate requests.

How this skill works

The skill issues REST calls to https://habitapp.ai/api/v1 using the Authorization: Bearer header with your HABITAI_API_KEY. For meals, you analyze photos or descriptions locally, build the required JSON structure (including nutritionalSummary/ingredients), optionally upload an image to get imageUrl, then POST /meals. It also supports endpoints for water, weight, steps, meditation, journal entries, profile retrieval/update, and AI coaching endpoints.

When to use it

• Log a meal with ingredient-level nutrition after analyzing a photo or description
• Upload a food photo then attach it to a meal record
• Quickly record water, weight, steps, or meditation sessions
• Fetch daily or weekly nutrition totals and remaining calories
• Call AI coaches for personalized eating or mindfulness advice

Best practices

• Always GET /profile first to honor diet and food sensitivities when scoring meals
• Analyze images/descriptions yourself and POST the exact meal JSON structure — do not call internal analyze endpoints
• Include mealName and a complete ingredients array; iOS requires mealName and nutritionalSummary to avoid zero calories
• Keep numeric fields as numbers (not strings) and ensure ingredient calories sum to total within ~5%
• Set analysisConfidenceLevel honestly (photos 6–8, descriptions 5–7) and provide short healthScoreExplanation and healthSensitivityExplanation if applicable

Example use cases

• User snaps lunch photo: upload image, estimate ingredients, POST /meals with imageUrl and nutrition breakdown
• Daily check-in: GET /nutrition/daily then GET /profile to compute remaining calories vs goal
• Hydration quick log: POST /water with amount in milliliters after each glass
• Weight or steps record: POST /weight or POST /steps to keep progress synced to profile and enable calorie burn estimates
• Ask AI eating coach: POST /coaches/eating with context to get personalized guidance