ai-recommendations

AI-powered recommendation engine specialist using Google AI SDK for personalized content suggestions

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill functions as a specialized AI recommendation engine expert, utilizing the Google AI SDK to architect and implement personalized content suggestion systems. It streamlines the complex process of integrating user preference data with LLMs, providing structured logic for prompt engineering, smart content filtering, and robust API error handling to ensure high-quality, relevant user experiences.

Use Cases

  • Personalized Media Discovery: Developing recommendation logic for streaming platforms that suggests movies or music based on user history, favorite creators, and specific genre preferences.
  • E-commerce Product Suggestions: Implementing 'Recommended for You' features that dynamically filter out disliked items and previously purchased products to increase conversion rates.
  • AI-Driven Content Curation: Building intelligent news or blog feeds that leverage structured AI outputs to surface relevant articles while managing API rate limits and caching for performance.
  • Technical SDK Integration: Providing developers with boilerplate code and best practices for configuring the Google AI SDK specifically for recommendation-based workflows.
nameai-recommendations
descriptionAI-powered recommendation engine specialist using Google AI SDK for personalized content suggestions

AI Recommendations Specialist

Instructions

When working with AI recommendations:

  1. Generating Recommendations

    • Collect user preferences from database
    • Build context with liked/disliked content
    • Include favorite actors and directors
    • Use structured prompts for consistent output
  2. AI Integration

    • Configure Google AI SDK in src/lib/ai/recommendations.ts
    • Use structured output for reliable parsing
    • Handle API errors and rate limits
    • Implement fallback recommendations
  3. Smart Filtering

    • Exclude already recommended content
    • Filter out user's disliked items
    • Ensure content is available
    • Apply content rating restrictions
  4. Performance

    • Cache recommendations to reduce API calls
    • Batch multiple user requests
    • Generate recommendations asynchronously
    • Store results for quick retrieval

Examples

Generating recommendations:

import { generateRecommendations } from '@/lib/ai/recommendations'

const recommendations = await generateRecommendations({
  userId: 'user-123',
  preferences: userPrefs,
  count: 10
})

Building AI prompt context:

const context = {
  likedContent: user.preferences.liked,
  dislikedContent: user.preferences.disliked,
  favoritePeople: user.preferences.people,
  recentlyRecommended: user.recommendations,
  genres: user.favoriteGenres
}

Handling AI response:

const response = await model.generateContent(prompt)
const { text } = response.response
const recommendations = JSON.parse(text)
// Validate and filter recommendations