Update to JoomPulse

{
  "name": "top-keywords-in-my-category",
  "description": "Lists the top trending search keywords for one Mercado Livre (Brasil) category — the real Mercado Livre search-trends ranking of what shoppers look for — with each keyword's rank and how many products compete for it. Use it when a seller wants to know what people search in their niche, which terms to put in titles and ads, or where demand is concentrated. Triggers include: \"top keywords in my category\", \"trending search terms\", \"what do people search for\", \"best keywords for my listings\", and the pt-BR equivalents \"palavras-chave mais buscadas\", \"termos em alta na categoria\", \"o que as pessoas pesquisam\", \"melhores palavras-chave para meus anúncios\". The keywords and ranks are real search-trend data, not estimates. For category market size and opportunity, use the category-opportunity-index skill; for ranking the sellers in a category, use the top-sellers-in-category skill.",
  "included_files": [],
  "skill_md_contents": "---\nname: top-keywords-in-my-category\ndescription: >\n  Lists the top trending search keywords for one Mercado Livre (Brasil) category\n  — the real Mercado Livre search-trends ranking of what shoppers look for — with\n  each keyword's rank and how many products compete for it. Use it when a seller\n  wants to know what people search in their niche, which terms to put in titles\n  and ads, or where demand is concentrated. Triggers include: \"top keywords in my\n  category\", \"trending search terms\", \"what do people search for\", \"best keywords\n  for my listings\", and the pt-BR equivalents \"palavras-chave mais buscadas\",\n  \"termos em alta na categoria\", \"o que as pessoas pesquisam\", \"melhores\n  palavras-chave para meus anúncios\". The keywords and ranks are real search-trend\n  data, not estimates. For category market size and opportunity, use the\n  category-opportunity-index skill; for ranking the sellers in a category, use the\n  top-sellers-in-category skill.\n---\n\n# Top Keywords In My Category\n\nThis skill returns the **top trending search keywords** for one Mercado Livre\n(Brasil) category — the ranked list of terms shoppers are actually searching,\neach with its position and how many products already compete for it. It tells a\nseller what to put in titles and ads and where demand is concentrated.\n\nUnlike most JoomPulse skills, the data here is **real search-trend data, not an\nestimate**. For a category's market size and opportunity index, use the\ncategory-opportunity-index skill. For the sellers ranked inside a category, use the\ntop-sellers-in-category 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- The available JoomPulse tools can resolve a category and return its trending\n  search keywords with each keyword's rank and competing-product count.\n\nIf JoomPulse MCP access is unavailable, stop and explain that the skill requires\nJoomPulse MCP setup before it can list a category's keywords.\n\n## Scope\n\n- **Mercado Livre (Brasil) only.** Other marketplaces are out of scope.\n- **Real data, not an estimate.** The keywords, ranks, and competing-product\n  counts come from Mercado Livre search trends — say so; do not add the sales\n  estimate disclaimer that other skills use.\n- **Read-only.** The skill never writes or modifies anything.\n- **Language:** detect the seller's language and respond in it. Default to pt-BR.\n- **Keep the workflow invisible.** Show `—` for any missing value; never fabricate.\n\n## Workflow\n\n### Step 1 — Resolve the category\n\nAsk for a category if none was given, then use JoomPulse to match the free text to\na category, disambiguating with the seller when several plausible matches return.\n\n### Step 2 — Get the trending keywords\n\nUse JoomPulse to retrieve the category's trending search keywords, each with its\nrank and its competing-product count. Sort by rank, best position first.\n\n## Output\n\nRespond in the seller's language (default pt-BR). The keywords always render as a\nmarkdown table, sorted by position. The headers below are the pt-BR default and\nmay be rendered in the seller's language:\n\n| Posição | Palavra-chave | Produtos (oferta) |\n|--:|---|--:|\n\n- **Posição** — the keyword's rank in the category's search trends.\n- **Produtos (oferta)** — the number of active offers (listings) matching that\n  keyword, i.e. how many products currently compete for it. This is a real\n  search-trend count, not an estimate.\n\nClose with a short, optional takeaway (use the top terms in titles and ads; a high\ncompeting-product count means a crowded term, a low one a more open opportunity).\n\nThis is **real Mercado Livre search-trend data, not an estimate** — state that\nonce, in place of the estimate disclaimer.\n\n## Visualization\n\nWhen the client can render inline visuals, present metric cards and a chart;\notherwise fall back to the markdown table plus text cards. Never block on visuals.\nThe keywords table always renders as markdown, on every surface.\n\nWhen inline visuals are available:\n\n- **Three cards:** number of keywords, the number-one term, and the least-disputed\n  term (the one with the fewest competing products among the top).\n- **A horizontal bar** of the top ~15 keywords (in rank order) showing the\n  competing-product count per term, so the most-searched terms and how crowded\n  each is are visible at a glance. Optionally flag low-competition (opportunity)\n  terms. Render the chart only when there are enough keywords (skip under about\n  five).\n\nPresentation rules: render a chart only when the data supports it.\n\n## Notes & Guardrails\n\nThe seller should never see a system or stack error — only a friendly next step.\n\n- **No keywords for the category:** say plainly that no trending terms were found\n  and suggest a broader or adjacent category.\n- **Data temporarily unavailable:** retry once quietly; if it is still down, say\n  the data is temporarily unavailable and to try again. Never paste internal error\n  text, HTTP codes, or field names to the seller.\n"
}