// Manage the AI coaching system for NutriProfile. Use this skill when working with personalized nutrition advice, daily tips, motivational messages, challenges, or the coaching features. Handles user context, streak management, and gamification integration.
| name | ai-coach |
| description | Manage the AI coaching system for NutriProfile. Use this skill when working with personalized nutrition advice, daily tips, motivational messages, challenges, or the coaching features. Handles user context, streak management, and gamification integration. |
| allowed-tools | Read,Write,Edit,Grep,Glob,Bash |
You are an AI coaching expert for the NutriProfile application. This skill helps you work with the personalized coaching system that provides nutrition advice, motivation, and challenges.
NutriProfile's AI Coach uses Mistral and Llama models to generate personalized advice based on:
backend/app/agents/coach.py - Coaching agent implementationbackend/app/api/v1/coaching.py - Coaching API endpointsbackend/app/models/gamification.py - Achievement, Streak, UserStats modelsbackend/app/services/gamification.py - Gamification logicfrontend/src/components/dashboard/CoachingCard.tsx - Daily coaching widgetfrontend/src/components/dashboard/AchievementBadge.tsx - Badge displayfrontend/src/components/dashboard/StreakCounter.tsx - Streak visualizationclass UserStats(Base):
id: int
user_id: int
xp: int # Experience points
level: int # 1-50
total_meals_logged: int
total_recipes_generated: int
total_activities_logged: int
created_at: datetime
updated_at: datetime
class Achievement(Base):
id: int
user_id: int
achievement_type: str # 20+ badge types
unlocked_at: datetime
class Streak(Base):
id: int
user_id: int
streak_type: str # meal_logging, activity, water_intake
current_count: int
longest_count: int
last_activity_date: date
first_meal - Log first mealmeal_streak_7 - 7-day meal logging streakmeal_streak_30 - 30-day meal logging streakvariety_champion - Log 20 different foodsfirst_workout - Log first activityactivity_streak_7 - 7-day activity streakcalorie_burner - Burn 10,000 calories totalprotein_master - Hit protein target 7 daysbalanced_week - Stay within macros for 7 dayshydration_hero - Meet water goal 14 dayschef_beginner - Generate first recipechef_expert - Generate 50 recipesearly_adopter - Join in first monthloyal_user - Active for 90 daysasync def generate_advice(self, user_id: int) -> CoachingResponse:
# 1. Load user context
profile = await self.get_user_profile(user_id)
meals = await self.get_recent_meals(user_id, days=7)
stats = await self.get_user_stats(user_id)
streaks = await self.get_streaks(user_id)
# 2. Build context prompt
context = self._build_coaching_context(profile, meals, stats, streaks)
# 3. Generate advice with Mistral/Llama
advice = await self.query_model(context)
# 4. Add personalized tips
tips = self._generate_tips(profile, meals)
return CoachingResponse(
daily_tip=advice.daily_tip,
suggestions=advice.suggestions,
motivation_level=self._calculate_motivation(stats),
challenges=self._generate_challenges(profile),
confidence=advice.confidence
)
GET /api/v1/coaching/daily
Response:
{
"daily_tip": "Vous avez bien progressé cette semaine !",
"suggestions": [
"Ajoutez plus de légumes verts",
"Pensez à vous hydrater"
],
"motivation_level": "high",
"challenges": [
{
"type": "protein",
"target": 120,
"current": 85,
"reward_xp": 50
}
],
"confidence": 0.82
}
GET /api/v1/coaching/stats - User statisticsGET /api/v1/coaching/achievements - Unlocked badgesGET /api/v1/coaching/streaks - Current streaksPOST /api/v1/coaching/complete-challenge - Mark challenge done| Tier | Coach Messages/Day |
|---|---|
| Free | 1 |
| Premium | 5 |
| Pro | Unlimited |
def calculate_level(xp: int) -> int:
# Levels 1-50, exponential scaling
# Level 1: 0 XP
# Level 10: 1,000 XP
# Level 25: 10,000 XP
# Level 50: 100,000 XP
return min(50, int(1 + (xp / 100) ** 0.6))
const { data: coaching } = useQuery({
queryKey: ['coaching', 'daily'],
queryFn: () => coachingApi.getDaily(),
staleTime: 1000 * 60 * 60 // 1 hour cache
})
Use dashboard namespace:
dashboard.coaching.title - Widget titledashboard.coaching.tip - Daily tip labeldashboard.coaching.suggestions - Suggestions sectiondashboard.coaching.challenge - Challenge labelACHIEVEMENT_TYPES enum in gamification modelcoach.pyDesign and implement REST API endpoints for NutriProfile. Use this skill when creating new endpoints, modifying API schemas, working with Pydantic models, or ensuring OpenAPI compliance. Follows FastAPI best practices.
Manage PostgreSQL database for NutriProfile. Use this skill when working with SQLAlchemy models, Alembic migrations, query optimization, or database schema changes. Covers async operations and Fly Postgres deployment.
Deploy NutriProfile to production. Use this skill when deploying backend to Fly.io, frontend to Cloudflare Pages, managing secrets, running health checks, or troubleshooting deployment issues.
Manage internationalization for NutriProfile's 7 languages. Use this skill when adding translations, creating new i18n keys, checking translation coverage, or working with RTL support for Arabic. Ensures consistency across FR, EN, DE, ES, PT, ZH, AR.
Analyze food items and calculate nutritional values for NutriProfile. Use this skill when working with food detection, nutritional calculations, meal analysis, or the Vision page. Covers calories, proteins, carbs, fats, and portion estimation.
Generate and manage AI-powered recipes for NutriProfile. Use this skill when working with recipe generation, ingredients management, cooking instructions, or the Recipes page. Handles multi-model consensus (Mistral, Llama, Mixtral) and user dietary preferences.