Skip to content

[any order] Offer a downloadable file only where the client can produce one #38

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
fiharet34 wants to merge 1 commit into
base: main
Choose a base branch
from
Open

[any order] Offer a downloadable file only where the client can produce one #38

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 9 additions & 6 deletions skills/category-monitor/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -158,10 +158,12 @@ Two Shopee-specific cautions:

Render the snapshot table for **today**, headed with the marketplace, the
category name and the date — and, on Shopee, the month the aggregates cover.
This table is the deliverable — and **offer it as a downloadable file (`.csv` /
`.xlsx`)** so the user can save it and bring it back next period as the
baseline. On a standalone snapshot there is **no change column and no color-dot
legend** — just metric and current value.
This table is the deliverable. **Where the client can produce files, also offer
it as a downloadable `.csv` / `.xlsx`** so the user can save it and bring it
back next period as the baseline; where it cannot, the markdown table stands on
its own — never offer a download you cannot deliver. On a standalone snapshot
there is **no change column and no color-dot legend** — just metric and current
value.

### Step 4 — Offer comparison, and compare if a previous table is supplied

Expand All @@ -183,8 +185,9 @@ an incomplete month.
Respond in the seller's language (default pt-BR). Name the marketplace the
figures came from.

**Snapshot (always):** a markdown table `| Métrica | Valor atual |`, plus a
downloadable `.csv` / `.xlsx` of the same data.
**Snapshot (always):** a markdown table `| Métrica | Valor atual |`, plus —
where the client can produce files — a downloadable `.csv` / `.xlsx` of the
same data.

- **Mercado Livre** rows: **Vendas (estimadas), Produtos, Produtos de catálogo,
Vendedores, Distribuição de medalhas, Monopolização**.
Expand Down
9 changes: 5 additions & 4 deletions skills/ml-product-analysis/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -315,10 +315,11 @@ Shopee:
> histórico são rastreados, então esta lista é um piso. Preço, classificação e
> avaliações são histórico real da Shopee.

**Download** — offer a downloadable spreadsheet (`.xlsx` plus `.csv`) of the
subject and analogs. On Mercado Livre give separate Mercado Livre and JoomPulse
link columns so the seller can see the source of every product's data; on Shopee
give the item and shop link columns instead, and use the Shopee column set.
**Download** — where the client can produce files, offer a downloadable
spreadsheet (`.xlsx` plus `.csv`) of the subject and analogs. On Mercado Livre
give separate Mercado Livre and JoomPulse link columns so the seller can see
the source of every product's data; on Shopee give the item and shop link
columns instead, and use the Shopee column set.

## Notes & Guardrails

Expand Down
4 changes: 2 additions & 2 deletions skills/product-change-monitor/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -260,8 +260,8 @@ Shopee:
> avaliações são histórico real da Shopee, e esse histórico começa em maio de
> 2026.

**Download** — offer a downloadable spreadsheet (`.xlsx` plus `.csv`) of the
change table.
**Download** — where the client can produce files, offer a downloadable
spreadsheet (`.xlsx` plus `.csv`) of the change table.

## Notes & Guardrails

Expand Down
17 changes: 10 additions & 7 deletions skills/seller-overview-tracker/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -148,12 +148,14 @@ numbers.
### Step 2 — Present today's snapshot and offer it for download

Lay out the snapshot fields as a table, headed with the store name, the
**marketplace** and the date. This table is the deliverable — and **offer it as a
downloadable file (`.csv` / `.xlsx`)** so the user can save it and bring it back
next period as the baseline. If any field comes back empty, show `—`; never
substitute a guess. On Mercado Livre add the JoomPulse seller dashboard link; on
Shopee link the shop on Shopee instead — **there is no JoomPulse dashboard link
for Shopee**, so never invent one. On a standalone snapshot there is **no change
**marketplace** and the date. This table is the deliverable. **Where the client
can produce files, also offer it as a downloadable `.csv` / `.xlsx`** so the
user can save it and bring it back next period as the baseline; where it
cannot, the markdown table stands on its own — never offer a download you
cannot deliver. If any field comes back empty, show `—`; never substitute a
guess. On Mercado Livre add the JoomPulse seller dashboard link; on Shopee link
the shop on Shopee instead — **there is no JoomPulse dashboard link for
Shopee**, so never invent one. On a standalone snapshot there is **no change
column and no color-dot legend** — just field and current value.

### Step 3 — Offer comparison, and compare if a previous table is supplied
Expand All @@ -174,7 +176,8 @@ Respond in pt-BR by default. Present the result with no commentary about how it
produced. Lead with a short line naming the **marketplace** and the store.

**Snapshot (always):** a markdown table `| Campo | Valor atual |` for the rows
below, plus a downloadable `.csv` / `.xlsx` of the same data.
below, plus — where the client can produce files — a downloadable `.csv` /
`.xlsx` of the same data.

**Snapshot / comparison rows (Mercado Livre)** — pt-BR labels:

Expand Down
9 changes: 5 additions & 4 deletions skills/top-brand-position-tracker/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -105,10 +105,11 @@ JoomPulse MCP setup before it can rank brands and track their positions.
### Step 2 — Present today's ranking and offer it for download

Render today's brand-ranking table (head it with the category name and the date).
This table is the deliverable — and **offer it as a downloadable file (`.csv` /
`.xlsx`)** so the user can save it and bring it back next period as the baseline.
On a standalone ranking there is **no movement column and no legend** — just the
ranking.
This table is the deliverable. **Where the client can produce files, also offer
it as a downloadable `.csv` / `.xlsx`** so the user can save it and bring it
back next period as the baseline; where it cannot, the markdown table stands on
its own — never offer a download you cannot deliver. On a standalone ranking
there is **no movement column and no legend** — just the ranking.

### Step 3 — Offer comparison, and compare if a previous table is supplied

Expand Down
11 changes: 7 additions & 4 deletions skills/top-sellers-in-category/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -76,9 +76,11 @@ as a cap — show fewer if fewer exist.
### Step 3 — Present today's leaderboard and offer it for download

Render the leaderboard for **today** (head it with the category name and the date).
This table is the deliverable — and **offer it as a downloadable file (`.csv` /
`.xlsx`)** so the user can save it and bring it back next period as the baseline.
On a standalone leaderboard there is **no movement column and no legend**.
This table is the deliverable. **Where the client can produce files, also offer
it as a downloadable `.csv` / `.xlsx`** so the user can save it and bring it
back next period as the baseline; where it cannot, the markdown table stands on
its own — never offer a download you cannot deliver. On a standalone
leaderboard there is **no movement column and no legend**.

### Step 4 — Offer comparison, and compare if a previous leaderboard is supplied

Expand All @@ -98,7 +100,8 @@ leaderboard. The change column header is a word ("Variação"), never a bare "Δ

Respond in the seller's language (default pt-BR).

**Leaderboard (always):** a markdown table, plus a downloadable `.csv` / `.xlsx`:
**Leaderboard (always):** a markdown table, plus — where the client can produce
files — a downloadable `.csv` / `.xlsx`:

| 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 |
|---|--:|--:|--:|--:|--:|--:|--:|--:|--:|--:|--:|
Expand Down
Loading