alpacalabsllc/product-pair
Suggest complementary products that pair well with a given item — side tables for sofas, task lights for desks, etc. Use when the user asks "what goes with" a product, wants coordinating pieces, or asks to complete a furniture grouping.
npx skills add https://github.com/AlpacaLabsLLC/skills-for-architects --skill product-pair
"What goes with this?" Takes a product and suggests complementary items across different categories — a side table for a sofa, a floor lamp for a reading chair, a rug for a dining table. Returns 5-8 pairings with reasoning rooted in design principles.
By name:
/as:product-pair Blu Dot Diplomat Sofa
By name + context:
/as:product-pair Blu Dot Diplomat Sofa for a tech office lounge
By product details:
/as:product-pair
Name: Diplomat Sofa
Brand: Blu Dot
Materials: Steel frame, fabric upholstery
Color: Edwards Navy
Style: Contemporary, minimal
Price: $2,499
Context: Corporate lounge, 6-person seating area
Identify the product's design DNA:
Based on the source product's category, identify what typically pairs with it:
| Source Category | Pair With |
|----------------|-----------|
| Sofa | Coffee table, side table, floor lamp, throw pillow, rug, ottoman |
| Lounge Chair | Side table, floor lamp, ottoman, throw |
| Dining Table | Dining chairs, pendant light, sideboard, rug |
| Desk | Task chair, desk lamp, monitor arm, desk organizer |
| Bed | Nightstands, table lamps, bench, rug, dresser |
| Conference Table | Conference chairs, credenza, pendant/linear light |
| Task Chair | Desk, monitor arm, task light |
If the designer provided context (e.g., "tech office lounge"), factor that into category selection.
For each pairing category, search for products that match the source's:
Run 2-3 searches per pairing category. Target 5-8 total pairings across different categories.
## Pairings for: Diplomat Sofa — Blu Dot
Source: Contemporary minimal, steel/navy fabric, $2,499
### Coffee Table
**Minimalista Coffee Table — Blu Dot** · $799
48"W × 24"D × 16"H · Steel, glass
Same brand, same design language. Steel frame echoes the sofa's base.
### Side Table
**Swole Small Side Table — Blu Dot** · $349
15" dia × 18"H · Steel, solid walnut top
Adds warmth with walnut. Low profile sits well next to the sofa arm height.
### Floor Lamp
**IC F1 — Flos** · $695
14" dia × 53"H · Brass, opal glass
Sculptural counterpoint to the sofa's linearity. Brass warms the cool navy.
### Throw Pillow
**Dot Dash Pillow — Loom Decor** · $89
20" × 20" · Linen blend
Texture contrast against the sofa fabric. Available in coordinating colorways.
### Rug
**Sathi Rug — Armadillo** · $1,450
8' × 10' · Wool, undyed
Neutral base grounds the navy. Contract-grade durability.
---
## Pairing Summary
| Category | Product | Brand | Price | Why |
|----------|---------|-------|-------|-----|
| Coffee Table | Minimalista | Blu Dot | $799 | Same language, steel continuity |
| Side Table | Swole Small | Blu Dot | $349 | Walnut warmth, right height |
| Floor Lamp | IC F1 | Flos | $695 | Brass accent, sculptural form |
| Pillow | Dot Dash | Loom Decor | $89 | Texture contrast |
| Rug | Sathi | Armadillo | $1,450 | Neutral ground, contract-grade |
**Total pairing package: $3,382**
If the designer picks pairings, prepare complete rows for the nearest project-root product-library.csv. Read ../../schema/product-schema.md and ../../schema/csv-conventions.md. Preview all chosen pairings 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 pair:{source-product-name} for traceabilityNotes: Paired with {source product}. {Design reasoning}Status: savedSource: product-pair/as:product-match — match finds alternatives to the source, pair finds complements/as:product-research — research finds products from a brief, pair builds around an anchor piece/as:product-enrich — enrich paired products with full metadata/as:product-data-import — import the source + pairings into the master scheduleTake alpacalabsllc/product-pair from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
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.