> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anagram.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Build a recommendation quiz

> Turn your agent into a guided product finder with one skill and one suggestion.

Product quizzes convert because they do the shopper's thinking for them. The usual version is a rigid form built in a quiz app. Your agent can run the same play conversationally: ask a few questions, then recommend real products from your catalog, and handle the follow-up questions a form never could.

This guide builds one with a single [skill](/brain/skills). Plan on 15 minutes.

## Before you start

Your [catalog](/brain/knowledge#catalog) needs to be connected, since the recommendations come from your synced products. That's it.

## Step 1: Write the quiz as a skill

Go to **Brain → Skills** and create a new skill. Here's a worked example for a skincare brand; adapt the questions and logic to your products.

**Skill name**

```text theme={null}
Routine finder quiz
```

**When should this skill be used?**

```text theme={null}
When a shopper asks for a recommendation, says they don't know
what to choose, asks to take the quiz, or asks what's right for
their skin.
```

The trigger is what makes the quiz fire at the right moments, so cover the different ways shoppers express "help me choose." Notice it isn't just "when they ask for the quiz"; anyone signaling indecision is a quiz candidate.

**Instructions**

```text theme={null}
Run a short quiz to find the right routine. Ask one question at a
time and wait for the answer before asking the next.

1. Ask about their skin type: oily, dry, combination, or not sure.
   If they're not sure, ask whether their skin feels tight after
   washing (dry) or gets shiny by midday (oily).
2. Ask what their main goal is: clearer skin, fewer fine lines,
   more hydration, or evening out tone.
3. Ask if they have any sensitivities or ingredients they avoid.
4. Recommend 2 or 3 products from the catalog that fit their
   answers, as a routine: cleanser first, then treatment, then
   moisturizer. For each one, say in one sentence why it fits
   what they told you.
5. Ask if they'd like alternatives at a different price point.

Keep it light. Never diagnose skin conditions; if they mention a
medical concern, suggest they see a dermatologist.
```

A few things this example does that are worth copying:

* **One question at a time.** Without that line, the agent may dump all the questions at once, which kills the quiz feel.
* **A recovery path for "not sure".** Shoppers who'd bounce off a form dropdown will answer "does your skin feel tight after washing?"
* **A capped recommendation count.** Two or three products with reasons beats a wall of options.
* **A closing offer.** The price-point question keeps the conversation going instead of ending on a list.

Save the skill.

## Step 2: Test it

Use the preview chat and come at the quiz from different angles: "what should I buy?", "I'm new to skincare", "take the quiz". Check that it triggers each time, asks one question at a time, and recommends sensible products.

If it recommends oddly, the fix is usually in the instructions: add a line like "never recommend the exfoliating toner for sensitive skin." If a product detail is wrong, that's a catalog or [knowledge](/brain/knowledge) fix instead.

## Step 3: Make the quiz discoverable

The skill only helps shoppers who talk to the agent, so put the quiz in front of them:

* **Add a suggestion chip.** In your placement's [suggestions](/launch/suggestions), switch to Fixed suggestions and add "Find my routine" or "Take the 30-second quiz" as a chip, or keep Auto mode and rely on the agent surfacing it. A fixed chip is the more reliable pull.
* **Pin it where it's relevant** with a [suggestion set](/launch/suggestion-sets). A set targeting your bestselling collection can open with "Not sure which is right for you? Take the quiz."
* **Give the quiz its own placement.** An [Embedded inline](/launch/placements) placement on a "Find your routine" landing page turns the quiz into a destination you can link from email and ads.

## Variations

The same skeleton works for most guided-selling problems. Change the questions and the recommendation logic:

* **Gift finder**: who's it for, occasion, budget, then two or three options.
* **Fit finder**: current brand and size, fit preference, then one size recommendation with your brand's sizing quirks baked into the instructions.
* **Bundle builder**: their goal, what they already own, then a set of products that work together.

If you build one you're proud of, we'd genuinely like to see the transcript. Send it to [support@anagram.ai](mailto:support@anagram.ai).