Update to JoomPulse

{
  "description": "Ranks the top sellers in one Mercado Livre (Brasil) category by estimated average monthly revenue via JoomPulse, and returns a downloadable leaderboard — per seller: estimated monthly sales and revenue, 365-day completed sales, cancellation rate, sales trend, brands, product counts, international shipping, and listing-type counts, with a JoomPulse link each. It can also track how the ranking moved: supply a previous-period leaderboard for the same category and it shows each seller's movement (rose / fell / new) plus the biggest movers. Triggers: \"top sellers in this category\", \"biggest stores in a category\", \"rank sellers by revenue\", and the pt-BR \"principais vendedores da categoria\", \"maiores lojas da categoria\", \"quem mais vende nessa categoria\". Sales and revenue are JoomPulse estimates, not real transactions. To monitor one seller over time use the seller-overview-tracker skill; to rank brands use the top-brand-position-tracker skill.",
  "included_files": [],
  "name": "top-sellers-in-category",
  "skill_md_contents": "---\nname: top-sellers-in-category\ndescription: >\n  Ranks the top sellers in one Mercado Livre (Brasil) category by estimated average monthly\n  revenue via JoomPulse, and returns a downloadable leaderboard — per seller: estimated\n  monthly sales and revenue, 365-day completed sales, cancellation rate, sales trend, brands,\n  product counts, international shipping, and listing-type counts, with a JoomPulse link each.\n  It can also track how the ranking moved: supply a previous-period leaderboard for the same\n  category and it shows each seller's movement (rose / fell / new) plus the biggest movers.\n  Triggers: \"top sellers in this category\", \"biggest stores in a category\", \"rank sellers by\n  revenue\", and the pt-BR \"principais vendedores da categoria\", \"maiores lojas da categoria\",\n  \"quem mais vende nessa categoria\". Sales and revenue are JoomPulse estimates, not real\n  transactions. To monitor one seller over time use the seller-overview-tracker skill; to rank\n  brands use the top-brand-position-tracker skill.\n---\n\n# Top Sellers In Category\n\nThis skill returns the **top sellers in one Mercado Livre (Brasil) category**,\nranked by estimated average monthly revenue. For each seller it shows estimated\naverage monthly sales and revenue, completed sales over the last 365 days,\ncancellation rate, sales trend, brands, how their products split between all\nlistings and listings with sales, international shipping, and classic versus\npremium listing counts.\n\nBy default it produces **today's leaderboard** as a downloadable table. It can\nalso show **how the ranking moved over time**: if you supply a previous-period\nleaderboard that this skill produced for the same category, it compares the two\nand reports each seller's movement (rose / fell / new) plus the biggest movers.\n**The baseline is the table you supply — there is no hidden session memory.**\n\nTo monitor a single named seller over time, use the seller-overview-tracker skill.\nTo rank brands rather than sellers, use the top-brand-position-tracker skill.\n\n## Prerequisites\n\n- JoomPulse MCP access is configured for the current agent environment.\n- The user names a category (free text is fine).\n- For a period comparison, the user supplies a previous leaderboard that this\n  skill produced for the same category (pasted or uploaded). Without it, the skill\n  produces a standalone leaderboard.\n- The available JoomPulse tools can find the sellers active in a category and\n  return each seller's profile (estimated average monthly sales and revenue,\n  last-365-day completed sales, cancellation rate, sales trend, brands, listing\n  distribution, international shipping, classic and premium listing counts).\n  Seller medal — used to color the chart — and reputation are read when available.\n\nIf JoomPulse MCP access is unavailable, stop and explain that the skill requires\nJoomPulse MCP setup before it can rank a category's sellers.\n\n## Scope\n\n- **Mercado Livre (Brasil) only.** Other marketplaces are out of scope.\n- **Sales and revenue are JoomPulse estimates** derived from historical listing\n  data — not real transactions. Cancellation rate and last-365-day completed sales\n  are real history. Disclose the estimate caveat in every output.\n- **Read-only.** The skill never writes or modifies anything; it does not store the\n  leaderboard — the user keeps the downloadable table and brings it back next period.\n- **Language:** detect the seller's language and respond in it. Default to pt-BR.\n- **The baseline is user-supplied.** Never claim a movement without a previous\n  leaderboard to compare against, and never infer or fabricate one from memory.\n\n## Workflow\n\n### Step 1 — Resolve the category and find its sellers\n\nAsk for a category if none was given, then use JoomPulse to match the free text to\na category and find the sellers active in it.\n\n### Step 2 — Rank by estimated average monthly revenue\n\nRank the sellers by **estimated average monthly revenue**, highest first. Keep a\nsensible top (default about 50, up to about 100 on request), and treat the count\nas a cap — show fewer if fewer exist.\n\n### Step 3 — Present today's leaderboard and offer it for download\n\nRender the leaderboard for **today** (head it with the category name and the date).\nThis table is the deliverable — and **offer it as a downloadable file (`.csv` /\n`.xlsx`)** so the user can save it and bring it back next period as the baseline.\nOn a standalone leaderboard there is **no movement column and no legend**.\n\n### Step 4 — Offer comparison, and compare if a previous leaderboard is supplied\n\nInvite the user to send a previous leaderboard for the same category to compare\nperiods. **If they provide one**, align by seller and report:\n\n- a **Variação** column per seller: 🟢 subiu N / 🔴 caiu N / 🆕 novo / = igual, and\n  note sellers that **left** the top in a short \"saíram do top\" line;\n- a short **Destaques** block — biggest risers 🟢 and biggest fallers 🔴.\n\nA movement **requires both an old and a new position/value** for the same seller —\nno previous entry means \"novo\", never a fabricated trend. Show the 🟢/🔴 legend\n**only** in the comparison (where the markers actually appear), never on a plain\nleaderboard. The change column header is a word (\"Variação\"), never a bare \"Δ\".\n\n## Output\n\nRespond in the seller's language (default pt-BR).\n\n**Leaderboard (always):** a markdown table, plus a downloadable `.csv` / `.xlsx`:\n\n| Vendedor | Vendas méd. (mês) | Receita média (mês) | Vendas 365d | Cancel rate | Sales trend | Marcas | Produtos (todos) | Produtos (com venda) | Envio internacional | Classic | Premium |\n|---|--:|--:|--:|--:|--:|--:|--:|--:|--:|--:|--:|\n\n- The **Vendedor** name links to the seller's JoomPulse page.\n\n**Comparison (only when a previous leaderboard is supplied):** the same table plus\na **Variação** column, and a **Destaques** block (maiores altas / maiores quedas).\n\n**Disclaimer (every report):**\n\n> ⚠️ Vendas e receita são estimativas do JoomPulse com base no histórico de\n> anúncios — não são transações reais. Taxa de cancelamento e vendas dos últimos\n> 365 dias são dados reais do Mercado Livre.\n\n## Visualization\n\nWhen the client can render inline visuals, present metric cards and charts;\notherwise fall back to the markdown table plus text cards. Never block on visuals.\nThe leaderboard (and the comparison, when present) always renders as markdown in\nthe response text, the downloadable file mirrors it, and the ⚠️ disclaimer always\nstays in the text.\n\nWhen inline visuals are available:\n\n- **Four cards:** number of sellers in the category (and how many have sales), the\n  leader's share of the shortlist's revenue, the average monthly revenue across\n  the top, and the average ticket.\n- **A horizontal bar** of the top ~10 sellers by estimated average monthly revenue,\n  **colored by seller medal** — platina = purple, ouro = amber, prata = blue, sem\n  medalha = white with a thin border (white needs the border to stay visible on a\n  light background). Include a small legend mapping color to medal. When one seller\n  dwarfs the rest, you may show that leader as a separate highlighted figure and\n  chart the remaining leaders so the medal colors stay readable.\n- **A small \"registered versus with sales\" comparison** for sellers and for\n  products, to show how much of the supply actually converts.\n\nPresentation rules: use the medal palette consistently; render a chart only when\nthe data supports it; the movement/Variação column uses a word header, never a bare\n\"Δ\", and its 🟢/🔴 legend appears only when a comparison is shown.\n\n## Notes & Guardrails\n\nThe seller should never see a system or stack error — only a friendly next step.\n\n- **No previous leaderboard supplied:** render today's leaderboard only (no\n  movement column, no legend) and invite the user to save it for next time.\n- **Supplied table is for a different category, malformed, or unreadable:** say so\n  plainly and fall back to the leaderboard only; do not force a misaligned comparison.\n- **Small sample:** if only a few sellers come back, say so rather than implying it\n  is the whole category.\n- **Market data temporarily unavailable:** retry once quietly; if it is still\n  down, say market data is temporarily unavailable and to try again. Never paste\n  internal error text, HTTP codes, or field names to the seller.\n- **Never silently limit coverage** — state the top cap you used.\n"
}