---
name: crear-tablero
description: "Build or style a Frepi dashboard (tablero) from saved queries: pick one chart per widget, and let the dashboard draw the workspace brand by default. Use when the user asks for a dashboard, tablero, gráficas or widgets, or to change how a dashboard or widget looks (colors, fonts, style)."
license: "Proprietary. Free to use with a Frepi account. See LICENSE."
metadata:
  author: "frepi-ai"
  version: "1"
---

# Crear un tablero

A dashboard is a grid of widgets, each backed by a saved query. Every number comes from a saved
query; never type one by hand. A report (informe) is another thing: use `crear-reporte`.

## Tools

- **Copilot (Inicio):** `build_dashboard` builds the whole board in one step. Its card is the
  plan and the approval. New board: pass `name`. Existing board: pass `dashboard_id` (find it
  with `list_dashboards`). `widgets` has one entry per query (`query_id`, `chart`), in display
  order.
- **MCP:** `bi_create_dashboard` (a `name`), then `bi_add_widget` for each widget, and
  `bi_update_widget` to change one afterwards.
- Save each query first with `save_query` (MCP: `bi_save_query`). A query that cannot be saved
  means no widget for it: say so.

## Choose the chart

- `kpi`: one number.
- `line` or `area`: a series over time.
- `bar`: compare categories.
- `pie`: parts of a whole.
- `table`: detail rows.

One chart per widget. Check the numbers against the query before you say the board is ready.

## Brand

1. Read the brand first, without asking: `list_assets(kind="brand")` (the same name
   over MCP: `list_assets`). It returns the resolved brand: the workspace kit, else the host's theme,
   else the Frepi default or neutral, plus `brand.level`.
2. A dashboard draws that brand on its own. Most widgets need no palette and no color.
   `color_palette="marca"` means the brand colors.
3. The rules (what is used, when a color carries meaning, voice, the empty-kit suggestion) are
   in the shared reference: `get_skill(name="crear-reporte", reference="marca")` (MCP:
   `bi_get_skill(name="crear-reporte", reference="marca")`). Read its «Tableros» section.
4. In short:
   - Set `series_colors` or `kpi_color` only when a color carries meaning: the primary color
     on the main number, the accent on the comparison series.
   - Never set colors outside the kit unless the user asks for another look («pide otro aspecto»,
     for example «hazlo en tonos verdes»). Then the request wins for that widget.
   - Write titles and text cards in the brand's `voice`.
   - Never use another company's brand.
   - If `brand.level` is `frepi_default` or `neutral`, use it and suggest once, in one line,
     that the operator fills the kit in Recursos › Marca.