agentsclimarketplace

Algo rec hybrid

Skill charlieviettq/awesome-agent-skill/.cursor/skills/asgard-ai-platform/algo-rec-hybrid

Design hybrid recommendation systems combining multiple strategies for improved accuracy. Use this skill when the user needs to overcome single-method limitations, combine collaborative and content-based filtering, or build a production recommendation pipeline — even if they say 'combine recommendation approaches', 'best recommendation architecture', or 'cold start plus personalization'.From its SKILL.md

Install
npx -y skills add charlieviettq/awesome-agent-skill --skill algo-rec-hybrid

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 24 stars24 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

4.3 KB, 815 tokens by cl100k_base, as published. Nobody here has run it

Hybrid Recommendation System

Overview

Hybrid recommendation combines multiple strategies (CF, content-based, knowledge-based) to overcome individual method limitations. Common architectures: weighted, switching, cascade, feature augmentation, and meta-level. Complexity varies by architecture.

When to Use

Trigger conditions:

  • Building a production recommendation system that must handle cold start AND personalization
  • Single methods have known weaknesses for your use case
  • Need to balance accuracy, diversity, and coverage

When NOT to use:

  • When you have a single clean data source (start with the matching single method first)
  • When system simplicity is more important than marginal accuracy gains

Algorithm

IRON LAW: Hybrid Adds Value ONLY With Complementary Strengths
Combining two systems with the SAME weakness amplifies the weakness.
CF fails on cold start + content-based fails on cold start = hybrid
STILL fails on cold start. Choose components that cover each other's gaps.

Phase 1: Input Validation

Identify available data: interaction history (for CF), item features (for content-based), contextual signals (time, device, location). Map data to method capabilities. Gate: At least two complementary data sources available.

Phase 2: Core Algorithm

Weighted hybrid: Score = α × CF_score + β × CB_score. Tune weights via cross-validation.

Switching hybrid: Use CF when sufficient data exists; switch to content-based for cold start items/users.

Cascade hybrid: First stage filters (e.g., content-based), second stage ranks (e.g., CF) within filtered set.

Feature augmentation: Use one method's output as input features for another (e.g., CF embeddings as content features).

Phase 3: Verification

A/B test hybrid vs individual components. Measure: accuracy (NDCG, precision@K), coverage (% of catalog recommended), diversity (intra-list diversity). Gate: Hybrid outperforms best individual component on primary metric.

Phase 4: Output

Return recommendations with source attribution for explainability.

Output Format

{
  "recommendations": [{"item_id": "789", "score": 0.91, "sources": {"cf": 0.85, "content": 0.95}, "method": "weighted"}],
  "metadata": {"architecture": "weighted", "weights": {"cf": 0.6, "content": 0.4}, "coverage": 0.78}
}

Examples

Sample I/O

Input: New user with 2 interactions + rich item feature catalog Expected: Switching hybrid: content-based recommendations (insufficient CF data), transitioning to CF as interactions accumulate

Edge Cases

InputExpectedWhy
Completely new user + new itemFall back to popularityNo data for either method
Methods disagree stronglyDepends on architectureWeighted averages; cascade defers to second stage
One component returns emptyOther component takes overGraceful degradation

Gotchas

  • Complexity cost: Each added component increases latency, maintenance, and debugging difficulty. Start simple, add complexity only when justified by metrics.
  • Weight tuning: Static weights degrade over time. Retune periodically or use learned weights (e.g., a meta-model that predicts which component performs best per context).
  • Evaluation is harder: You must evaluate the hybrid AND each component individually to understand contribution and detect regressions.
  • Feature leakage: In feature augmentation, ensure the augmenting model's predictions don't leak test-set information during training.
  • Diminishing returns: Going from one method to two gives the biggest lift. Adding a third rarely justifies the complexity.

References

  • For architecture selection decision guide, see references/architecture-selection.md
  • For A/B testing recommendation systems, see references/ab-testing-recs.md

What ships with it: 3 files

27.8 KB alongside SKILL.md

examples/

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.