Skip to content

Add my-product-vs-catalog skill#4

Open
norightsforlis wants to merge 1 commit into
joomcode:mainfrom
norightsforlis:add-my-product-vs-catalog
Open

Add my-product-vs-catalog skill#4
norightsforlis wants to merge 1 commit into
joomcode:mainfrom
norightsforlis:add-my-product-vs-catalog

Conversation

@norightsforlis

Copy link
Copy Markdown
Contributor

Summary

Adds a new skill my-product-vs-catalog to the catalog.

It compares a seller's own Mercado Livre listing against every other seller of the same catalog product — the buy-box competition — and tells them, in pt-BR, where they win, where they lose, and what to fix first. For each parameter (price, free shipping, Mercado Envios Full, listing type, reviews, rating, seller reputation/medal, official store) it assigns a status — 🟢 Melhor / 🟡 Na média / 🟠 Pior / 🔴 Criticamente pior — and returns a verdict, a comparison table, a prioritized action list, and a downloadable spreadsheet. It can also arm a weekly monitor that reports what changed.

It complements the existing skills: single-product analysis (a product plus comparable products) and the change-monitor (one product over time). This one is about competing inside one catalog product.

Changes

  • skills/my-product-vs-catalog/SKILL.md — new skill (frontmatter + public workflow).
  • README.md — added the skill to the Skills table.
  • CHANGELOG.md — noted under Unreleased.

Notes

  • Mercado Livre (Brasil) only; sales and revenue are JoomPulse estimates, not real transactions.
  • Documentation-only and public-safe per CONTRIBUTING.md: no scripts, internal paths, private service names, or implementation details. Directory name matches the frontmatter name.

🤖 Generated with Claude Code

Adds a documentation-style SKILL.md for catalog buy-box competitiveness:
compares a seller's Mercado Livre listing against every other seller of the
same catalog product, classifies each parameter (Melhor / Na média / Pior /
Criticamente pior), and returns a verdict, comparison table, and prioritized
actions, with an optional weekly monitor. Updates the README skills table and
the CHANGELOG.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@profunctor

Copy link
Copy Markdown
Collaborator

KISS review: this skill over-promises in a few user-visible places.

  • It advertises an optional weekly monitor via a scheduling skill, but this repo does not include such a skill, so agents may promise a capability the plugin cannot provide.
  • It says the report compares against “every other seller” / the “full set”, while the edge case allows sampled large catalogs. Please phrase this as “available competing listings” and require sample disclosure.
  • Reviews/rating are listed as scored dimensions even though the body correctly says catalog-shared metrics are usually not comparable.

I’d remove the monitoring section and simplify the public promise before merging.

@profunctor

Copy link
Copy Markdown
Collaborator

Review — my-product-vs-catalog

Summary: A documentation-only skill that compares a seller's own Mercado Livre (Brasil) listing against every other seller of the same catalog product (the buy-box competition). It scores each parameter (price, free shipping, Mercado Envios Full, listing type, reviews/rating, photos, seller reputation/medal, official store) on a four-level color scale, then returns a pt-BR verdict, comparison table, prioritized action list, optional competitors table, and a downloadable spreadsheet, with an optional weekly monitor.

Findings:

  • minor — Inconsistent disclaimer format. Both sibling skills include a verbatim ⚠️ blockquote disclaimer with parallel EN/pt-BR text "in every output"; this skill only has a prose "Disclaimer — sales and revenue are JoomPulse estimates…" with no blockquote and no pt-BR text. Reuse the established bilingual blockquote so it renders in the seller's language.
  • minor — "Photos — best-effort count" may overpromise. Photo count is not a field the sibling skills surface from JoomPulse, and Prerequisites only assert listing/buy-box market data. If it isn't reliably obtainable it'll often fall to "dado indisponível." The capability may be aspirational.
  • nit — The frontmatter description parameter list omits "photos", which the body lists under both "Parameters Compared" and the prioritization. Align them.

Triggering is good (well-scoped, EN+pt-BR triggers, explicit disambiguation from the two siblings). README row + CHANGELOG entry correctly added; directory name == name. No scripts, internal paths/URLs, or leaked field names. The one item to address before merge is the bilingual blockquote disclaimer (#1); the rest is polish.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants