Update to JoomPulse

{
  "name": "uncontested-niche-finder",
  "description": "Finds low-competition niche products on Mercado Livre (Brasil) — active listings in deep sub-categories (deeper than the third level) of a chosen category that have no platinum seller at all, surfaced via JoomPulse. Use it when a seller wants uncontested niches, gaps without strong incumbents, or where to enter without fighting a dominant platinum seller. Triggers (EN): \"uncontested niche\", \"low-competition products\", \"categories without platinum sellers\", \"find a niche to enter\"; (pt-BR): \"nicho sem concorrência\", \"produtos sem vendedor platinum\", \"nicho pouco disputado\", \"subcategorias sem platinum\". It returns one table of niche products, each with a competition signal (number of sellers) and a JoomPulse link. Sales and revenue are JoomPulse estimates, not real transactions; price, rating, and reviews are real history. For one product and its competitors use the ml-product-analysis skill; for fast-growing deep categories rather than products use the growing-leaf-category-tracker skill.",
  "included_files": [],
  "skill_md_contents": "---\nname: uncontested-niche-finder\ndescription: >\n  Finds low-competition niche products on Mercado Livre (Brasil) — active listings in deep\n  sub-categories (deeper than the third level) of a chosen category that have no platinum\n  seller at all, surfaced via JoomPulse. Use it when a seller wants uncontested niches, gaps\n  without strong incumbents, or where to enter without fighting a dominant platinum seller.\n  Triggers (EN): \"uncontested niche\", \"low-competition products\", \"categories without platinum\n  sellers\", \"find a niche to enter\"; (pt-BR): \"nicho sem concorrência\", \"produtos sem vendedor\n  platinum\", \"nicho pouco disputado\", \"subcategorias sem platinum\". It returns one table of\n  niche products, each with a competition signal (number of sellers) and a JoomPulse link.\n  Sales and revenue are JoomPulse estimates, not real transactions; price, rating, and reviews\n  are real history. For one product and its competitors use the ml-product-analysis skill; for\n  fast-growing deep categories rather than products use the growing-leaf-category-tracker\n  skill.\n---\n\n# Uncontested Niche Finder\n\nThis skill finds products in **deep sub-categories** of a chosen Mercado Livre\n(Brasil) category — sub-categories deeper than the third level — that have **no\nplatinum seller at all** among their listings. These are genuinely\nplatinum-free niches a seller can enter without fighting a dominant incumbent.\nGiven a category by name or identifier, it surfaces the active listings in those\ndeep niches, and ranks them by estimated traction so the strongest uncontested\nopportunities surface first.\n\nA truly uncontested niche is a **whole deep sub-category with zero platinum\nsellers** — not merely the non-platinum listings inside a sub-category that\nstill has platinum sellers elsewhere. Dropping individual platinum-held listings\nis not enough: if any platinum seller is active in the sub-category, that niche\nis contested, so the skill keeps only the deep sub-categories that have no\nplatinum seller present. If keeping only platinum-free sub-categories would leave\ntoo few results, the skill may also show non-platinum listings from sub-\ncategories that still have platinum sellers — but it labels those plainly as\n**non-platinum listings (platinum sellers still present in the category)** and\ndoes not call them uncontested.\n\nThis is different from broad assortment work. To size up one product and the\nproducts that compete with it, use the ml-product-analysis skill. To find the\nfast-growing deep **categories** under a category (rather than the products inside\nthem), use the growing-leaf-category-tracker skill. This skill answers \"where can\nI enter without facing a platinum seller?\" for a category the seller names.\n\n## Prerequisites\n\n- JoomPulse MCP access is configured for the current agent environment.\n- The user provides one category, as a name or a category identifier.\n- The available JoomPulse tools can resolve a category, walk its deep\n  sub-categories, and list the active product listings within them.\n\nIf JoomPulse MCP access is unavailable, stop and explain that the skill requires\nJoomPulse MCP setup before it can find uncontested niches.\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. Disclose this in every output. By contrast,\n  **price, rating, and review count are real Mercado Livre history** — say so, it\n  is a strength of the report.\n- **Read-only.** The skill does not sign in as the seller or modify any listing.\n- **Language:** detect the seller's language and respond in it. Default to pt-BR.\n- **Keep the workflow invisible.** The seller wants the niches, not a play-by-\n  play. If one approach does not return data, switch to another quietly; only if\n  every approach fails do you say one short, friendly sentence. Never fill gaps\n  from general knowledge.\n\n## Workflow\n\n### Step 1 — Resolve the category and find its deep sub-levels\n\n1. **Ask the user for a category** (a name or a category identifier). If given a\n   name, use JoomPulse to resolve it to a category, matching on the category\n   name. If several categories match, briefly list the candidates (name and\n   level) and ask which one is meant.\n2. **Find every sub-category deeper than the third level** that sits under the\n   chosen category. Use JoomPulse to walk down the category tree from the chosen\n   branch and collect the descendant categories below the third level. Keep that\n   set of deep category identifiers for the next step.\n3. If the chosen category is itself at or above the third level and has no\n   descendants below it, tell the user there are no deep sub-levels for it and\n   offer to run on a broader category.\n\n### Step 2 — Keep only the platinum-free deep sub-categories\n\n1. Use JoomPulse to list the **active product listings** in those deep\n   sub-categories. For each listing collect: name, category, seller, listing\n   type, seller medal, logistics (frete grátis), price, estimated **weekly**\n   sales and revenue, rating, review count, time on air, and — where available —\n   how many sellers compete on the listing.\n2. **Decide which deep sub-categories are genuinely uncontested.** A deep sub-\n   category is uncontested only when it has **no platinum seller at all** among\n   its listings. Group the listings by their deep sub-category, check each group\n   for any platinum seller, and **keep only the sub-categories with zero platinum\n   sellers.** Do not merely drop the platinum-held listings from a sub-category\n   that still has platinum sellers — that sub-category is contested and its other\n   listings are not uncontested.\n3. From the platinum-free sub-categories, keep the listings that are real, funded\n   niches — those with estimated sales above zero — and rank them so the\n   strongest uncontested opportunities lead (by estimated weekly revenue by\n   default). If nothing has estimated sales, fall back to listing the active\n   listings in the platinum-free sub-categories and say so. These are the\n   **uncontested niches.**\n4. **If keeping only platinum-free sub-categories leaves too few results**, you\n   may additionally include the non-platinum listings from sub-categories that\n   still have platinum sellers — but present them in a clearly separate, labelled\n   group, **\"non-platinum listings (platinum sellers still present in the\n   category)\"**, and do **not** call them uncontested. Always lead with the\n   genuinely platinum-free niches.\n5. If every deep sub-category has at least one platinum seller (none are\n   platinum-free), report that the deep sub-categories are already contested by\n   platinum sellers, suggest a sibling category, and — if helpful — offer the\n   non-platinum listings under the labelled non-uncontested group described\n   above.\n\n## Output\n\nRespond in the seller's language. Present the result with no commentary about how\nit was produced. The product table always renders as markdown so it reads\ncleanly in any client.\n\n**Niche table** — one row per uncontested niche product (from the platinum-free\ndeep sub-categories), with these columns:\n\n- Product / listing identifier (rendered as a JoomPulse link for the product)\n- Name\n- Category\n- Seller\n- Price\n- Estimated sales (weekly)\n- Estimated revenue (weekly)\n- **Number of sellers** — the competition signal, so \"uncontested\" is legible\n  (show `—` when it is not available)\n- Rating\n- Reviews\n- Time on air\n- Free shipping (frete grátis)\n- Listing type\n- Seller medal — gold, silver, or no medal (never platinum; uncontested rows\n  come only from platinum-free sub-categories per Step 2)\n- A JoomPulse link for the product\n\nPut the JoomPulse link on the product identifier in each row. When a cell is\nempty, show `—` rather than guessing. Below the table, briefly state what\n\"uncontested niche\" means here: sub-categories deeper than the third level that\nhave **no platinum seller at all** among their listings. You may translate the\ncolumn headers into the seller's language.\n\n**If you also include the fallback group** (non-platinum listings from sub-\ncategories that still have platinum sellers, used only when the platinum-free set\nis too small), put it in a clearly separate, labelled section titled\n**\"non-platinum listings (platinum sellers still present in the category)\"**.\nUse the same columns, but do **not** call these rows uncontested — be explicit\nthat platinum sellers are still active in those sub-categories.\n\n**Disclaimer (every report):**\n\n> ⚠️ Sales and revenue are JoomPulse **estimates** based on historical listing\n> data — they are **not** actual transactions. Price, rating, and reviews are\n> real Mercado Livre history. / Vendas e receita são **estimativas** do JoomPulse\n> com base no histórico de anúncios — **não são transações reais**. Preço,\n> classificação e avaliações são histórico real do Mercado Livre.\n\n## Visualization\n\nWhen the client can render inline visuals, present metric cards and, when the\ndata supports it, the appropriate chart; otherwise present a short text version\nof the cards. **The product table always renders as markdown** — never inside a\nwidget — so the competition signal stays legible. Render a chart only when the\ndata supports it, and skip it otherwise.\n\n**Cards** — three summary cards:\n\n- **Produtos encontrados** — the count of uncontested niche rows in the table\n  (non-platinum, in deep sub-categories).\n- **Subnichos cobertos** — the count of distinct deep sub-categories actually\n  represented in the results.\n- **Ticket médio** — the average price across the listed rows, in pt-BR currency\n  formatting (for example `R$ 1.234`).\n\n**Chart** — a horizontal bar of the top niche products by estimated weekly\nrevenue, strongest uncontested niches first, each bar labelled with a short\nproduct name. **Skip the bar entirely when there are fewer than four products** —\nshow only the cards and the table.\n\n**Otherwise (no inline visuals)**: render the three cards as a short text block,\none line each, and — only when there are four or more products — a tiny text list\nof the top niches by estimated weekly revenue. **Never block on visuals**; if\ninline rendering is unavailable or fails, fall straight through to the markdown\noutput. Round numbers and use pt-BR formatting (for example `R$ 1.234`, `1.234\nvendas`).\n\n## Notes & Guardrails\n\nThe seller should never see a system or stack error — only a friendly next step.\n\n- **No deep sub-categories:** if the chosen category has no sub-levels deeper\n  than the third level, say so and offer to run on a broader category.\n- **No platinum-free sub-categories:** if every deep sub-category has at least\n  one platinum seller, report that the deep sub-categories are already contested\n  by platinum sellers and suggest a sibling category. You may still offer the\n  non-platinum listings, but only under the labelled \"non-platinum listings\n  (platinum sellers still present in the category)\" group — never as uncontested.\n- **Too few platinum-free niches:** if the genuinely platinum-free sub-categories\n  yield too few results, you may add the non-platinum listings from sub-\n  categories that still have platinum sellers, in the separate labelled group\n  above — always lead with the platinum-free niches and never relabel the\n  fallback group as uncontested.\n- **No funded listings:** if no listing has estimated sales, list the active\n  listings in the platinum-free sub-categories instead and say the niche has\n  little measured traction.\n- **Unknown flags:** when a logistics flag such as frete grátis is unknown, show\n  it as unknown — do not assume \"no\".\n- **Many deep sub-categories:** when the deep category set is large, gather the\n  listings in batches and merge the results before ranking.\n- **Market data temporarily unavailable:** retry once quietly; if it is still\n  down, say market data is temporarily unavailable. Never paste internal error\n  text, HTTP codes, or field names to the seller.\n- **Never silently limit coverage** — if you cover only some of the deep\n  sub-categories, say so.\n"
}