Agent skill

Algo Rec Hybrid

by asgard-ai-platform in asgard-ai-platform/skills

Design hybrid recommendation systems combining multiple strategies for improved accuracy.

MITAuto-check passed

Install Algo Rec Hybrid

skills CLI
$ npx skills add asgard-ai-platform/skills --skill algo-rec-hybrid -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install asgard-ai-platform/skills algo-rec-hybrid --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/asgard-ai-platform/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/algo-rec-hybrid .claude/skills/algo-rec-hybrid && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
algo-rec-hybrid
GitHub stars
242
Token cost
~1.1k tokens
SKILL.md length
411 words
Files
4 (incl. references)
Skills in repo
207
Repo updated
First seen
Licence
MIT

At a glance

Design hybrid recommendation systems combining multiple strategies for improved accuracy.

  • Works in 4 steps: Input Validation → Core Algorithm → Verification → …
  • The user needs to overcome single-method limitations
  • SKILL.md covers Overview, When to Use, Algorithm and Output Format, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Algo Rec Hybrid is an agent skill from asgard-ai-platform/skills. 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'.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `examples/sample_scenario.md`, `references/ab-testing-recs.md` and `references/architecture-selection.md`).

The repository describes itself as: 301 open-source coding agent skills across 22 domains — methodology, judgment & gotchas packaged as Claude Agent Skills for the Asgard AI Platform. The licence is MIT.

When your agent uses it

  • The user needs to overcome single-method limitations
  • Combine collaborative and content-based filtering
  • Build a production recommendation pipeline — even if they say combine recommendation approaches
  • Best recommendation architecture

Example prompts

  • “combine recommendation approaches”
  • “best recommendation architecture”
  • “cold start plus personalization”
  • “/algo-rec-hybrid”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Input Validation
  2. Core Algorithm
  3. Verification
  4. Output

What it can do on your machine

Read from SKILL.md and the folder at commit 4e7f4f8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Algo Rec Hybrid loads about 1.1k tokens when it runs, and up to ~7k if it reads all its reference files. Until then it costs about 102 tokens; SKILL.md has 411 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~102
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from asgard-ai-platform/skills at commit 4e7f4f8, republished under its MIT licence (© asgard-ai-platform). 411 words, ~1,105 tokens.

Download SKILL.mdSave it as .claude/skills/algo-rec-hybrid/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
algo-rec-hybrid
description
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'.
metadata.category
WP-36 推薦系統
metadata.tags
recommendation, hybrid, ensemble, system-design

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

json
{
  "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

Show full SKILL.md (155 more words)Show less
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

© asgard-ai-platform, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in algo-rec-hybrid of asgard-ai-platform/skills.

  • SKILL.md
  • examples/sample_scenario.md
  • references/ab-testing-recs.md
  • references/architecture-selection.md

Open the folder on GitHubat commit 4e7f4f8

Compare with similar skills

Algo Rec Hybrid next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Algo Rec Hybrid compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Algo Rec Hybrid this skillasgard-ai-platform/skills242—~1.1kAutomated safety check: PassMIT
Bid Strategy Recommendationsirinabuht12-oss/marketing-skills4.1k—~735Automated safety check: PassNone
Good Strategy Bad Strategywondelai/skills2.4k—~4.8kAutomated safety check: PassMIT
Product Strategyphuryn/pm-skills27k—~1.2kAutomated safety check: PassMIT
Launch Strategyalirezarezvani/claude-skills28k—~1.4kAutomated safety check: PassMIT
Pricing Strategyalirezarezvani/claude-skills28k1 repos~3.5kAutomated safety check: PassMIT

Similar skills

  • Bid Strategy Recommendations

    irinabuht12-oss/marketing-skills

    Analyzes your campaign history, conversion volume, CPA targets, and auction dynamics, then recommends the right bid strategy for each campaign — manual CPC, target CPA, target ROAS, maximize…

    4.1k GitHub stars~735 tokensUpdated 17 days ago
    Marketing & SEOAuto-check passed
  • Formulate and audit real strategy using Richard Rumelt's "Good Strategy Bad Strategy": an honest diagnosis, a guiding policy, and coherent action instead of goals, vision, and wishful thinking.

    2.4k GitHub stars~4.8k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Product Strategy

    phuryn/pm-skills

    Create a comprehensive product strategy using the 9-section Product Strategy Canvas — vision, segments, costs, value propositions, trade-offs, metrics, growth, capabilities, and defensibility.

    27k GitHub stars~1.2k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Launch Strategy

    alirezarezvani/claude-skills

    When the user wants to plan a product launch, feature announcement, or release strategy.

    28k GitHub stars~1.4k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Pricing Strategy

    alirezarezvani/claude-skills

    Design, optimize, and communicate SaaS pricing — tier structure, value metrics, pricing pages, and price increase strategy.

    28k GitHub starsUsed in 1 repo~3.5k tokens
    Sales & SupportAuto-check passed
  • Monetization Strategy

    phuryn/pm-skills

    Brainstorm 3-5 monetization strategies with audience fit, risks, and validation experiments.

    27k GitHub stars~1.7k tokensUpdated yesterday
    Sales & SupportAuto-check passed

More from asgard-ai-platform/skills

All 207 skills in this repo
  • Algo Ecom Bm25

    asgard-ai-platform/skills

    Implement BM25 ranking function for e-commerce product search relevance scoring.

    242 GitHub stars~1.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Mfg Cpk

    asgard-ai-platform/skills

    Calculate Cpk process capability index to assess whether a process meets specification requirements.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Price Elasticity

    asgard-ai-platform/skills

    Calculate price elasticity of demand to quantify how price changes affect sales volume.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Rank Bayesian

    asgard-ai-platform/skills

    Apply Bayesian averaging to rank items by combining observed ratings with prior expectations.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Rank Elo

    asgard-ai-platform/skills

    Implement Elo rating system to rank items or players from pairwise comparison outcomes.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Algo Rank Wilson

    asgard-ai-platform/skills

    Calculate Wilson Score confidence intervals for ranking items by positive proportion with sample size correction.

    242 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed

Questions about Algo Rec Hybrid

What does Algo Rec Hybrid do?

Design hybrid recommendation systems combining multiple strategies for improved accuracy. Algo Rec Hybrid is an agent skill from asgard-ai-platform/skills. Design hybrid recommendation systems combining multiple strategies for improved accuracy.

When should I use Algo Rec Hybrid?

Algo Rec Hybrid fits situations like: the user needs to overcome single-method limitations; combine collaborative and content-based filtering; build a production recommendation pipeline — even if they say combine recommendation approaches; best recommendation architecture.

How do I install Algo Rec Hybrid in Claude Code?

Run `npx skills add asgard-ai-platform/skills --skill algo-rec-hybrid -a claude-code`. Or copy the skill folder (algo-rec-hybrid in asgard-ai-platform/skills) into .claude/skills/algo-rec-hybrid in your project. Claude Code loads it when a task matches its description.

How do I install Algo Rec Hybrid in Codex?

Run `npx skills add asgard-ai-platform/skills --skill algo-rec-hybrid -a codex`. Or copy the skill folder (algo-rec-hybrid in asgard-ai-platform/skills) into .agents/skills/algo-rec-hybrid in your project. Codex loads it when a task matches its description.

Can I use Algo Rec Hybrid in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add asgard-ai-platform/skills --skill algo-rec-hybrid -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/algo-rec-hybrid, .gemini/skills/algo-rec-hybrid, .github/skills/algo-rec-hybrid and .opencode/skills/algo-rec-hybrid in your project.

What does Algo Rec Hybrid need to run?

SKILL.md names no scripts, command-line tools or credentials: Algo Rec Hybrid is instructions for the agent only.

Does Algo Rec Hybrid access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Algo Rec Hybrid safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Algo Rec Hybrid use?

Algo Rec Hybrid is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Algo Rec Hybrid use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.9k tokens, read only when the agent opens those files.

What are the alternatives to Algo Rec Hybrid?

Skills that share tags, products or a category with Algo Rec Hybrid: Bid Strategy Recommendations (irinabuht12-oss/marketing-skills, 4.1k stars), Good Strategy Bad Strategy (wondelai/skills, 2.4k stars), Product Strategy (phuryn/pm-skills, 27k stars) and Launch Strategy (alirezarezvani/claude-skills, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Algo Rec Hybrid?

asgard-ai-platform (a GitHub organization) maintains it in asgard-ai-platform/skills, which has 242 GitHub stars. The repository holds 207 skills in this directory. The repository was last updated on June 6, 2026.

Source: asgard-ai-platform/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.