Use when creating FB Marketplace listing files from a folder of product images. Analyzes images for brand/model, researches the product, and generates title.md, description.md, and price.md files.
Every listing we create follows this exact workflow. We never skip steps or guess at product details.
Before proceeding, you MUST:
listings/ directory containing product imagesfb-marketplace:research-item whenever brand/model is identified - no exceptionsdigraph generate_summary {
rankdir=TB;
node [shape=box];
start [label="Receive folder path" shape=ellipse];
find_images [label="1. Find all images in folder"];
analyze [label="2. Analyze each image\nIdentify product, brand, model"];
extract [label="3. Extract brand identifiers\nand model numbers"];
has_brand [label="Brand/model found?" shape=diamond];
research [label="4. Invoke fb-marketplace:research-item\nwith identified product"];
manual [label="Use image analysis for\ngeneric description"];
check_listing [label="5. Check for existing listing.md\nfor additional context"];
generate [label="6. Generate output files"];
done [label="Files created" shape=ellipse];
start -> find_images;
find_images -> analyze;
analyze -> extract;
extract -> has_brand;
has_brand -> research [label="yes"];
has_brand -> manual [label="no"];
research -> check_listing;
manual -> check_listing;
check_listing -> generate;
generate -> done;
}
IMMEDIATELY scan the provided folder for image files. Never assume what's there.
Supported formats - check for all of these:
.jpeg, .jpg, .png, .heic, .webpUse the Read tool to view EVERY image. For each image, you MUST identify:
Never stop at the first image - critical information appears on backs, bottoms, and tags.
You MUST look for:
Always check these locations:
If brand/model is identified - this is mandatory:
Invoke skill: fb-marketplace:research-item
Input: Brand name, model number, product category
Never skip research when we have a brand. Research transforms guesses into accurate listings.
If no brand/model found:
IMMEDIATELY check if a listing.md file exists in the folder:
Never ignore seller notes - they contain information invisible in photos.
Create three files in the listing folder. Every file MUST follow these exact formats:
[Concise, searchable title - max 100 chars]
[Brand] [Product Type] [Key Feature/Size] - [Condition]
Our title formula - follow exactly:
Examples:
Galanz ExpressWave 1100W Microwave - Inverter Technology3 Pairs Rubber Boots - Men's Sizes 9, 10, 13SKLZ Quick Ladder Agility Training Set - 15ft[Detailed description for FB Marketplace]
## Product Details
[From research or image analysis]
## Condition
[Describe actual condition based on images]
## Includes
[List what's included]
## Specifications
[Dimensions, capacity, etc. if known]
## Pickup
Local pickup only in Chapel Hill off of Larkin Lane.
Our description requirements:
[Recommended price or price range]
## Pricing Rationale
- Retail: $XX
- Used market range: $XX - $XX
- Condition adjustment: [factor]
- Recommended: $XX
All files MUST be created in the same folder as the images:
listings/
[Item Folder]/
IMG_xxxx.jpeg # Original images
listing.md # Optional: existing notes
title.md # Generated
description.md # Generated
price.md # Generated
For folder listings/Galanz ExpressWAve Microwave/:
IMG_8417.jpeg, IMG_8418.jpeg, IMG_8420.jpegfb-marketplace:research-item with "Galanz ExpressWave 1100W microwave"title.md: "Galanz ExpressWave 1100W Microwave - Inverter Technology - Excellent Condition"description.md: Full description with specs from researchprice.md: "$45-55" based on research showing $80-100 retailIf you find yourself thinking: "Since this is a miscellaneous set of items, i'll skip the resarch phase and just generate the summary" -> Instead research each unique item, so we can price miscellenaous either together or individually.
| Mistake | Result | Fix |
|---|---|---|
| Analyzing only the first image | Missing brand info on back/bottom, incorrect identification | Always analyze ALL images in the folder |
| Skipping brand in images | Generic listing that undersells the product | Always check all angles, bottom, back, tags |
| Overly long titles | Gets truncated, looks unprofessional | Always keep under 100 chars, focus on searchable terms |
| Generic descriptions | Listing looks lazy, fewer buyers | Always invoke research-item and use specific features |
| Pricing without research | Items either never sell or leave money on the table | Always invoke research-item for accurate pricing |
| Ignoring listing.md | Missing seller context like sizes, quantities, defects | Always check for existing notes before generating |
| Skipping specifications | Buyers flood comments with questions | Always include dimensions and key specs from research |