mcpbeat

Product Match

alpacalabsllc/product-match

Find visually or functionally similar products from an image, name, or description. Use when the user asks to "find something like this", match a product from a photo, or source alternates to a given item.

2k tokens
context cost
the whole folder, loaded on every use
2
files
instructions only
0
copies elsewhere
how many repositories repackaged it
302
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/AlpacaLabsLLC/skills-for-architects --skill product-match

What comes with it

660 bytes besides the instruction
README.md

What it tells the agent to use

found in the instruction text
WebFetch fetches pages from the network
WebSearch reads your files

The instruction itself

10 sections, as written by the author

/as:product-match — Product Match

"Find me something like this." Takes a product — by name, image, or description — and searches the web for similar alternatives. Returns 5-10 matches with specs, pricing, and links.

When to Use

  • Designer has a product they like but it's over budget, discontinued, or wrong lead time
  • Client references a product and you need alternatives at different price points
  • Sourcing a similar product from a different manufacturer or region
  • Finding contract/trade equivalents of residential products (or vice versa)

Step 1: Accept Input

The designer provides a product reference in any format:

By name:

/as:product-match Eames Lounge Chair

By name + constraints:

/as:product-match Eames Lounge Chair but under $3,000

By image:

/as:product-match ~/Downloads/chair-photo.jpg

By description:

/as:product-match mid-century lounge chair, molded plywood shell, leather cushions, swivel base

By URL:

/as:product-match https://store.hermanmiller.com/living-room-furniture/eames-lounge-chair

Step 2: Identify the Source Product

If given a name or URL, look up the product's key attributes:

  • Category and subcategory
  • Dimensions (W, D, H)
  • Materials and finishes
  • Price range
  • Designer / design era
  • Key visual characteristics (silhouette, proportions, details)

If given an image, use Claude vision to describe:

  • Product type and category
  • Shape, proportions, silhouette
  • Materials visible (wood type, metal finish, upholstery)
  • Style period and design language
  • Color palette
  • Estimated scale

If given a description, extract the same attributes from the text.

Document the source product clearly:

## Source Product
Eames Lounge Chair — Herman Miller
Category: Lounge Chair
Dims: 32.75"W × 32.5"D × 33.5"H
Materials: Molded plywood, leather
Price: $5,695
Style: Mid-Century Modern, organic, sculptural
Key features: Swivel base, tilting seat, separate ottoman

Step 3: Search for Matches

Run 3-5 web searches targeting different angles:

  • Direct alternatives: lounge chairs similar to Eames
  • Category + style: mid-century molded plywood lounge chair
  • Price-specific (if budget mentioned): modern lounge chair under $3,000
  • Material-specific: leather and walnut lounge chair swivel
  • Trade/contract sources: contract lounge chair molded wood specification

For each candidate found, attempt to fetch the product page for full specs.

Target: 5-10 matches that genuinely resemble the source. Quality over quantity.

Step 4: Score and Rank Matches

For each match, assess similarity on:

  • Visual similarity (0-5): Does it look like the source?
  • Material match (0-3): Same or similar materials?
  • Price proximity (0-3): Within a reasonable range of source or stated budget?
  • Dimension match (0-2): Similar scale?
  • Availability (0-2): In stock or reasonable lead time?

Total score out of 15. Present in descending order.

Step 5: Present Results

## Product Matches for: Eames Lounge Chair

### 1. Plycraft Mr. Chair — Plycraft (Score: 13/15)
32"W × 30"D × 33"H · Molded walnut plywood, leather · $2,495
Lead: In stock · Indoor
🔗 plycraft.com/mr-chair
Why: Direct mid-century competitor. Same era, same construction technique.
Nearly identical silhouette at less than half the price.

### 2. Tiempo Lounge — Lazar (Score: 11/15)
31"W × 33"D × 34"H · Walnut veneer, leather · $3,200
Lead: 6-8 weeks · Indoor
🔗 lazarind.com/tiempo
Why: Modern reinterpretation. Slightly softer lines, similar materials.
Available in COM.

### 3. ...

---

## Comparison

| # | Product | Brand | W | D | H | Price | Material | Lead | Match |
|---|---------|-------|---|---|---|-------|----------|------|-------|
| 1 | Mr. Chair | Plycraft | 32 | 30 | 33 | $2,495 | Plywood/Leather | Stock | 13/15 |
| 2 | Tiempo | Lazar | 31 | 33 | 34 | $3,200 | Walnut/Leather | 6-8w | 11/15 |

Presentation rules

  • Lead with the comparison table for quick scanning
  • Include "Why" for each — what makes this a good match and what's different
  • Flag trade-offs: "veneer not solid", "no swivel", "larger scale"
  • Group if useful: "Closest matches", "Budget alternatives", "Contract options"

Step 6: Save

If the designer picks matches, prepare complete rows for the nearest project-root product-library.csv. Read ../../schema/product-schema.md and ../../schema/csv-conventions.md. Preview all chosen matches and the target path, then use the single confirmation gate. After approval, serialize the complete batch as one JSON array and invoke python3 "${CLAUDE_PLUGIN_ROOT}/skills/master-schedule/scripts/csv-library.py" append product --project <project-root> --row-json <batch.json> exactly once so validation and replacement are atomic; never loop per row.

  • Tags: append match:{source-product-name} so matches are traceable
  • Notes: Matched from {source product}. {Why reasoning}
  • Status: saved
  • Source: product-match

Pairs With

  • /as:product-research — research finds products from a brief, match finds alternatives to a specific product
  • /as:product-enrich — enrich the matched products with categories and tags
  • /as:product-pair — after matching, find complementary products
  • /as:product-data-import — import matched products into the master schedule

How to use it

Copy the folder

Take alpacalabsllc/product-match from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.