agentleFS
Insightful-PipeInsightful-Pipe/marketing-skills/skills/shopping-feed-optimizer/SKILL.md

shopping-feed-optimizer

Skill0 starsChanged 35 days agoMITView on GitHub

Audits and optimizes product feeds for Google Shopping, Meta Catalog, and other platforms. Identifies feed quality issues, provides title/description optimization, and recommends feed structure improvements. Triggers when user asks about "product feed," "shopping feed," "Merchant Center," "catalog ads," "feed optimization," or has Shopping campaign performance issues. Essential for e-commerce advertisers.

1 other project uses a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 6 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Google/Meta Are Matching Engines: When someone searches "blue running shoes size 10," the algorithm matches that to product data.

    line 14
  2. Distinctive:

    Search query data from Shopping campaigns

    line 56
  3. Distinctive:

    Remove products that won't be back in stock

    line 203
  4. Distinctive:

    Use availability_date for preorders

    line 204
  5. Distinctive:

    Use the most specific category available

    line 233
  6. Distinctive:

    Use your internal categorization

    line 238

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Shopping Feed Optimizer

Your feed is the foundation. Bad feed = bad ads. No amount of bidding or targeting fixes a broken feed.

Core Philosophy

The Feed IS Your Ad. For Shopping and Catalog ads, you don't write ad copy, your product data becomes the ad. Every field matters.

Google/Meta Are Matching Engines. When someone searches "blue running shoes size 10," the algorithm matches that to product data. If your title doesn't say "blue running shoes," you won't show up.

Garbage In, Garbage Out. Platform algorithms optimize based on your feed data. Missing attributes, poor images, and bad titles limit what the algorithm can do.

Feed Quality = Impression Share. Google explicitly uses feed quality as a ranking factor. Better data = more visibility at the same bid.

The Title Is 80% of the Battle. Users see the title first. Google matches queries to titles first. Optimize titles before anything else.


Required Context

Must Have

1. Feed Access or Sample

  • Export of current product feed (CSV, XML, or Google Sheet)
  • OR sample of 10-20 products with all attributes
  • OR Merchant Center / Catalog Manager screenshots

2. Product Category

  • What type of products (apparel, electronics, home goods, etc.)
  • Google Product Category taxonomy used

3. Current Performance

  • Click-through rate by product/category
  • Impression share data (if available)
  • Disapproved products count
  • Top performing vs underperforming products

Strongly Recommended

4. Platform Context

  • Which platforms: Google Shopping, Meta, Pinterest, etc.
  • Country/market targets
  • Language requirements

5. Competitive Context

  • Competitor pricing (if known)
  • Category competition level

Nice to Have

  • Search query data from Shopping campaigns
  • Historical feed changes and results
  • Merchandising priorities (what to push)
  • Inventory levels and availability data

Feed Audit Framework

Audit Area 1: Required Attributes

Google Shopping Required Fields:

FieldRequirementCommon Issues
idUnique per productDuplicates, changes causing re-learning
title≤150 chars, accurateToo short, missing keywords
descriptionAccurate, detailedThin, duplicate, keyword stuffed
linkValid product pageBroken links, wrong pages
image_linkHigh quality, valid URLSmall images, wrong aspect ratio
priceAccurate, matches landingMismatch errors
availabilityin_stock/out_of_stockNot synced with website
brandAccurate brand nameMissing, generic
gtinValid UPC/EAN/ISBNMissing (major issue)
conditionnew/refurbished/usedMissing when required

GTIN Importance:

GTIN StatusImpact
Valid GTINFull visibility, all placements
Missing GTINReduced visibility, limited placements
Invalid GTINDisapproval risk

Meta Catalog Required Fields:

FieldRequirement
idUnique identifier
titleProduct name
descriptionProduct description
availabilityin stock / out of stock
conditionnew / refurbished / used
priceAmount + currency
linkProduct URL
image_linkProduct image URL
brandBrand name

Audit Area 2: Title Optimization

Title Formula by Category:

CategoryRecommended Structure
ApparelBrand + Gender + Product Type + Attributes (Color, Size, Material)
ElectronicsBrand + Product Line + Model + Key Specs
Home & GardenBrand + Product Type + Material + Key Feature + Size
BeautyBrand + Product Line + Product Type + Size/Volume
GenericBrand + Product Type + Key Differentiator + Variant

Title Best Practices:

DoDon't
Front-load important keywordsStart with brand if not well-known
Include color, size, materialUse ALL CAPS or excessive punctuation
Match search intentStuff keywords unnaturally
Be specific (150 chars available)Be generic ("Nice Shirt")
Include model numbers for electronicsInclude promotional text ("Sale!")

Title Optimization Examples:

Before (Weak)After (Optimized)
Running ShoesNike Air Zoom Pegasus 40 Men's Running Shoes - Black/White - Size 10
Blue DressZara Women's Midi Wrap Dress - Navy Blue - Size Medium - Cotton Blend
LaptopApple MacBook Pro 14" M3 Pro - 18GB RAM - 512GB SSD - Space Gray
Face CreamCeraVe Moisturizing Cream - 16oz - Daily Face and Body Moisturizer for Dry Skin

Title Scoring:

ScoreCriteria
⭐⭐⭐⭐⭐Brand + Type + 3+ Attributes + Key Differentiator
⭐⭐⭐⭐Brand + Type + 2 Attributes
⭐⭐⭐Brand + Type + 1 Attribute
⭐⭐Just brand + type
⭐Generic name only

Audit Area 3: Image Quality

Google Shopping Image Requirements:

RequirementSpecification
Minimum size100x100px (non-apparel), 250x250px (apparel)
Recommended size800x800px or higher
FormatJPEG, PNG, GIF, BMP, TIFF
BackgroundPrefer white/light solid background
Product visibilityProduct should fill 75-90% of frame

Image Quality Checklist:

FactorPassFail
Resolution≥800px longest side<250px, blurry
BackgroundWhite/cleanBusy, watermarks
Product focusProduct clearly visibleProduct too small
AccuracyMatches the variantGeneric image
ProfessionalismClean, well-litAmateur, dark
Text/overlaysNone or minimalPromotional text, logos

Image Optimization Priority:

  1. Top sellers - Best images first where it matters most
  2. High-margin products - Worth the investment
  3. Competitive categories - Stand out visually
  4. Underperformers - Image might be the issue

Audit Area 4: Pricing & Availability

Price Accuracy:

IssueImpactCheck
Price mismatch (feed vs site)DisapprovalDaily sync verification
Missing sale_priceLost opportunityAdd when on sale
Currency mismatchDisapprovalMatch target country
Price too low/highSuspension riskVerify accuracy

Availability Sync:

StatusFeed ValueWhen to Use
In stockin_stockAvailable to ship
Out of stockout_of_stockNot available
PreorderpreorderFuture availability
BackorderbackorderShips when available

Availability Best Practices:

  • Sync feed at least daily (hourly for fast-moving inventory)
  • Remove products that won't be back in stock
  • Use availability_date for preorders

Audit Area 5: Custom Labels Strategy

Custom Label Use Cases:

LabelUse CaseExample Values
custom_label_0Margin tierhigh_margin, medium_margin, low_margin
custom_label_1Bestseller statusbestseller, rising, standard, clearance
custom_label_2Seasonalityspring, summer, fall, winter, evergreen
custom_label_3Promotion statuspromo_eligible, full_price
custom_label_4New arrivalnew_arrival, core, legacy

Why Custom Labels Matter:

  • Bid differently by margin (bid higher on high-margin)
  • Segment campaigns by performance tier
  • Prioritize budgets to bestsellers
  • Seasonal control for inventory management
  • Reporting by business category

Audit Area 6: Product Type & Categories

Google Product Category:

  • Use the most specific category available
  • Required for some categories (apparel, media)
  • Improves matching accuracy

Product Type (Your Taxonomy):

  • Use your internal categorization
  • Format: Category > Subcategory > Sub-subcategory
  • Example: Apparel > Men's > Shoes > Running Shoes

Category Optimization:

IssueImpactFix
Too genericPoor matchingUse most specific available
MissingLimited optimizationAlways include
IncorrectWrong auctionsAudit and correct

Audit Area 7: Additional Attributes

Apparel-Specific (Required):

AttributeValues
gendermale, female, unisex
age_groupadult, kids, toddler, infant, newborn
colorActual color name
sizeStandardized sizing
size_typeregular, petite, plus, tall, big, maternity
size_systemUS, UK, EU, etc.

Optional But Valuable:

AttributeBenefit
additional_image_linkMultiple angles, lifestyle shots
product_highlightBullet points for comparison
product_detailAdditional specs
materialFiltering, matching
patternFiltering, matching
item_group_idGroups variants together
shippingOverride account-level shipping

Output Format

Feed Audit Report

═══════════════════════════════════════════════════════════════════
SHOPPING FEED AUDIT REPORT
═══════════════════════════════════════════════════════════════════
Feed: [Feed Name / Source]
Products Analyzed: [X]
Platforms: [Google / Meta / etc.]
Audit Date: [Date]
═══════════════════════════════════════════════════════════════════

📊 FEED HEALTH SCORE: [X/100]

| Category | Score | Priority |
|----------|-------|----------|
| Required Attributes | [X/25] | [P0/P1/P2] |
| Title Quality | [X/25] | [P0/P1/P2] |
| Image Quality | [X/20] | [P0/P1/P2] |
| Pricing & Availability | [X/15] | [P0/P1/P2] |
| Additional Attributes | [X/15] | [P0/P1/P2] |

TOP 3 ISSUES:
1. [Critical issue] - Affecting [X] products
2. [Issue #2] - Affecting [X] products
3. [Issue #3] - Affecting [X] products

QUICK WIN:
[Single highest-impact fix]

═══════════════════════════════════════════════════════════════════

📋 REQUIRED ATTRIBUTES AUDIT
────────────────────────────────────────────────────────────────────

| Attribute | Coverage | Quality | Issues |
|-----------|----------|---------|--------|
| id | [X]% | ✅/⚠️/❌ | [Issue description] |
| title | [X]% | ✅/⚠️/❌ | [Issue description] |
| description | [X]% | ✅/⚠️/❌ | [Issue description] |
| link | [X]% | ✅/⚠️/❌ | [Issue description] |
| image_link | [X]% | ✅/⚠️/❌ | [Issue description] |
| price | [X]% | ✅/⚠️/❌ | [Issue description] |
| availability | [X]% | ✅/⚠️/❌ | [Issue description] |
| brand | [X]% | ✅/⚠️/❌ | [Issue description] |
| gtin | [X]% | ✅/⚠️/❌ | [Issue description] |
| condition | [X]% | ✅/⚠️/❌ | [Issue description] |

CRITICAL GAPS:
- [Gap #1]: [X] products affected
- [Gap #2]: [X] products affected

═══════════════════════════════════════════════════════════════════

📝 TITLE OPTIMIZATION ANALYSIS
────────────────────────────────────────────────────────────────────

TITLE QUALITY DISTRIBUTION:

| Rating | Count | % of Feed |
|--------|-------|-----------|
| ⭐⭐⭐⭐⭐ Excellent | [X] | [X]% |
| ⭐⭐⭐⭐ Good | [X] | [X]% |
| ⭐⭐⭐ Average | [X] | [X]% |
| ⭐⭐ Weak | [X] | [X]% |
| ⭐ Poor | [X] | [X]% |

COMMON TITLE ISSUES:

| Issue | Frequency | Example |
|-------|-----------|---------|
| Missing brand | [X]% | "[Example title]" |
| No color/size | [X]% | "[Example title]" |
| Too short (<50 chars) | [X]% | "[Example title]" |
| Missing key attributes | [X]% | "[Example title]" |

TITLE OPTIMIZATION EXAMPLES:

| Product ID | Current Title | Optimized Title |
|------------|---------------|-----------------|
| [ID] | [Current] | [Recommended] |
| [ID] | [Current] | [Recommended] |
| [ID] | [Current] | [Recommended] |

═══════════════════════════════════════════════════════════════════

🖼️ IMAGE QUALITY ANALYSIS
────────────────────────────────────────────────────────────────────

IMAGE QUALITY DISTRIBUTION:

| Quality | Count | % of Feed |
|---------|-------|-----------|
| High quality | [X] | [X]% |
| Acceptable | [X] | [X]% |
| Needs improvement | [X] | [X]% |
| Poor/Problematic | [X] | [X]% |

IMAGE ISSUES IDENTIFIED:

| Issue | Frequency | Impact |
|-------|-----------|--------|
| Low resolution | [X] products | Reduced CTR |
| Busy background | [X] products | Distraction |
| Text overlays | [X] products | Policy risk |
| Wrong variant image | [X] products | Returns, disapprovals |

PRIORITY PRODUCTS FOR IMAGE UPDATE:
1. [Product] - [Reason]
2. [Product] - [Reason]
3. [Product] - [Reason]

═══════════════════════════════════════════════════════════════════

💰 PRICING & AVAILABILITY AUDIT
────────────────────────────────────────────────────────────────────

PRICING:
- Products with price: [X]%
- Products with sale_price: [X]%
- Price mismatches detected: [X]

AVAILABILITY:
- In stock: [X] products ([X]%)
- Out of stock: [X] products ([X]%)
- Sync frequency: [Daily/Weekly/Unknown]

ISSUES:
- [Issue #1]
- [Issue #2]

═══════════════════════════════════════════════════════════════════

🏷️ CUSTOM LABELS STRATEGY
────────────────────────────────────────────────────────────────────

CURRENT USAGE:
| Label | In Use | Values | Recommendation |
|-------|--------|--------|----------------|
| custom_label_0 | ✅/❌ | [Values] | [Recommendation] |
| custom_label_1 | ✅/❌ | [Values] | [Recommendation] |
| custom_label_2 | ✅/❌ | [Values] | [Recommendation] |
| custom_label_3 | ✅/❌ | [Values] | [Recommendation] |
| custom_label_4 | ✅/❌ | [Values] | [Recommendation] |

RECOMMENDED LABEL STRATEGY:
- custom_label_0: [Use case + values]
- custom_label_1: [Use case + values]
- custom_label_2: [Use case + values]

═══════════════════════════════════════════════════════════════════

🎯 OPTIMIZATION ROADMAP
────────────────────────────────────────────────────────────────────

IMMEDIATE (This Week):

1. [ ] [Action] - [Expected impact]
2. [ ] [Action] - [Expected impact]
3. [ ] [Action] - [Expected impact]

SHORT-TERM (Next 2 Weeks):

1. [ ] [Action] - [Expected impact]
2. [ ] [Action] - [Expected impact]

ONGOING:

1. [ ] [Process to establish]
2. [ ] [Process to establish]

═══════════════════════════════════════════════════════════════════

Common Scenarios

Scenario 1: "Shopping campaigns not spending"

Feed Checks:

  1. Merchant Center disapprovals?
  2. Missing GTINs on majority of products?
  3. Image quality issues?
  4. Price/availability mismatches?
  5. Product data quality warnings?

Fix Priority: Disapprovals → GTINs → Images → Data quality

Scenario 2: "Low CTR on Shopping ads"

Likely Feed Issues:

  1. Weak titles (missing keywords, too generic)
  2. Poor images (low quality, wrong variant)
  3. Price not competitive
  4. Missing ratings/reviews

Fix Priority: Titles → Images → Competitive pricing

Scenario 3: "High impressions, low clicks"

Diagnosis: Showing for queries but not compelling Check:

  1. Title relevance to search queries
  2. Image quality vs competitors
  3. Price comparison
  4. Missing promotional annotations

Scenario 4: "Products disapproved"

Common Causes by Type:

DisapprovalCommon CauseFix
Price mismatchFeed/site not syncedImprove sync frequency
Image qualityToo small, watermarksUpgrade images
GTIN issueInvalid or missingAdd/correct GTINs
Policy violationProhibited contentReview product content
Availability mismatchOOS on site, in stock in feedSync inventory

Scenario 5: "How often should I update my feed?"

Recommendations:

Business TypeMinimum FrequencyIdeal
Fast inventory changesEvery 4 hoursHourly
Standard e-commerceDailyTwice daily
Stable catalogDailyDaily
Flash sales / promosBefore and after saleHourly during sale

Limitations

I can provide:

  • Feed quality assessment
  • Title optimization recommendations
  • Attribute gap identification
  • Custom label strategy
  • Priority-based action plan

I cannot provide:

  • Direct feed editing/uploads
  • Merchant Center account access
  • Automated feed generation
  • Real-time disapproval resolution
  • Competitor feed analysis

For implementation, you'll need:

  • Feed management tool (Feedonomics, DataFeedWatch, GoDataFeed)
  • OR direct platform access
  • Developer resources for custom feeds

Quality Checklist

Before delivering audit:

  • All required attributes assessed
  • Title quality scored and examples provided
  • Image quality evaluated
  • Pricing/availability issues identified
  • Custom label strategy recommended
  • Specific product examples included
  • Optimization actions prioritized
  • Platform-specific requirements noted
  • Realistic timeline for improvements

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.