Skip to content

windmill-labs/windmill / system_prompts/auto-generated/skills/rich-results

rich-results

Verified

MUST use when a script or flow should return a table, chart, markdown, image, file or map instead of plain JSON.

FileKindSize
SKILL.mdskill md8.9 KB
---
name: rich-results
description: MUST use when a script or flow should return a table, chart, markdown, image, file or map instead of plain JSON.
---

# Rich results

Windmill renders a script's or flow's return value according to its shape: on run pages, in the
script and flow editors, in app result displays and in AI chat run cards. Anything that matches none
of the shapes below is shown as JSON.

## Shapes

- `{ "table-row-object": [{...}, ...] }`, or a bare array of objects: a table whose columns are the
  union of the objects' keys.
- `{ "table-col": { "col": [...], ... } }`, or a bare object of equal-length arrays: a table built
  column by column.
- `{ "table-row": [["col", ...], [v, ...], ...] }`: a table whose first row holds the column names.
- `{ "chart": {...} }`: a bar, line, pie or scatter chart drawn from rows (schema below). A `chart`
  value the schema rejects is shown as JSON, not as a broken chart.
- `{ "markdown": "..." }` (or `md`): rendered markdown.
- `{ "html": "..." }`: sanitized HTML.
- `{ "png": "<base64>" }`, likewise `jpeg`, `gif`, `svg`: an image. `{ "pdf": "<base64>" }`: a PDF.
- `{ "file": "<base64>", "filename": "report.csv" }`: a download.
- `{ "map": { "lat": 0, "lon": 0, "zoom": 3, "markers": [{ "lat": 0, "lon": 0, "title": "..." }] } }`:
  a map.
- `{ "s3": "path/to/key" }`: an object in the workspace storage, previewed by type.
- `{ "render_all": [ ... ] }`: each item rendered in turn with the rules above.

Each shape is an object with that one key (plus `filename` for a file, and an optional `storage` for
`s3`). A result carrying any other key beside it is shown as JSON.

## Choosing one

A chart answers a question at a glance: a trend over time (line), a comparison across categories
(bar), parts of a whole with few parts (pie), or a relation between two numbers (scatter). A table
answers lookups and holds the exact values. When both help, return both in a `render_all`: the chart
first, then the table of the same rows.

Keep a chart to what it shows well: at most 8 series. A pie with more than 8 slices keeps the 7
largest and folds the rest into "Other", so prefer a bar chart for many categories. Aggregate before
charting: a chart of thousands of raw points says less than one of the totals per day.

### Chart and table schema

A chart or table value, as JSON Schema. Beyond it: `x` and every `y` must be columns of `data`, `y` columns hold numbers, a scatter chart's `x` column holds numbers, and a pie chart takes exactly one `y`.

```json
{"$schema":"https://json-schema.org/draft/2020-12/schema","anyOf":[{"anyOf":[{"type":"object","properties":{"chart":{"type":"object","properties":{"type":{"description":"bar or line for categories or time, pie for parts of a whole, scatter for two numeric columns","type":"string","enum":["bar","line","pie","scatter"]},"title":{"type":"string"},"data":{"description":"The rows to plot, the same shape as a table-row-object result","minItems":1,"maxItems":5000,"type":"array","items":{"description":"One row: column name to value (string, number, boolean or null)","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"x":{"description":"Column holding the category, label or date of each row (bar, line, pie), or the numeric x value (scatter)","type":"string"},"y":{"description":"Numeric column, or columns, to plot: one series each. A pie takes exactly one","anyOf":[{"type":"string"},{"minItems":1,"maxItems":8,"type":"array","items":{"type":"string"}}]},"stacked":{"description":"bar and line: stack the series","type":"boolean"},"horizontal":{"description":"bar: draw the bars horizontally","type":"boolean"},"x_label":{"type":"string"},"y_label":{"type":"string"}},"required":["type","data","x","y"],"additionalProperties":false}},"required":["chart"],"additionalProperties":false},{"type":"object","properties":{"table-row-object":{"description":"Rows as objects; the columns are the union of their keys","minItems":1,"maxItems":5000,"type":"array","items":{"description":"One row: column name to value (string, number, boolean or null)","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}}},"required":["table-row-object"],"additionalProperties":false},{"type":"object","properties":{"table-col":{"description":"Columns: column name to its values, all the same length","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"maxItems":5000,"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}}},"required":["table-col"],"additionalProperties":false},{"type":"object","properties":{"table-row":{"description":"Rows as arrays; the first row holds the column names","minItems":2,"maxItems":5000,"type":"array","items":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}}},"required":["table-row"],"additionalProperties":false}]},{"type":"object","properties":{"render_all":{"description":"Several items shown one after another","minItems":1,"maxItems":10,"type":"array","items":{"anyOf":[{"type":"object","properties":{"chart":{"type":"object","properties":{"type":{"description":"bar or line for categories or time, pie for parts of a whole, scatter for two numeric columns","type":"string","enum":["bar","line","pie","scatter"]},"title":{"type":"string"},"data":{"description":"The rows to plot, the same shape as a table-row-object result","minItems":1,"maxItems":5000,"type":"array","items":{"description":"One row: column name to value (string, number, boolean or null)","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"x":{"description":"Column holding the category, label or date of each row (bar, line, pie), or the numeric x value (scatter)","type":"string"},"y":{"description":"Numeric column, or columns, to plot: one series each. A pie takes exactly one","anyOf":[{"type":"string"},{"minItems":1,"maxItems":8,"type":"array","items":{"type":"string"}}]},"stacked":{"description":"bar and line: stack the series","type":"boolean"},"horizontal":{"description":"bar: draw the bars horizontally","type":"boolean"},"x_label":{"type":"string"},"y_label":{"type":"string"}},"required":["type","data","x","y"],"additionalProperties":false}},"required":["chart"],"additionalProperties":false},{"type":"object","properties":{"table-row-object":{"description":"Rows as objects; the columns are the union of their keys","minItems":1,"maxItems":5000,"type":"array","items":{"description":"One row: column name to value (string, number, boolean or null)","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}}},"required":["table-row-object"],"additionalProperties":false},{"type":"object","properties":{"table-col":{"description":"Columns: column name to its values, all the same length","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"maxItems":5000,"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}}},"required":["table-col"],"additionalProperties":false},{"type":"object","properties":{"table-row":{"description":"Rows as arrays; the first row holds the column names","minItems":2,"maxItems":5000,"type":"array","items":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}}},"required":["table-row"],"additionalProperties":false}]}}},"required":["render_all"],"additionalProperties":false}]}
```

Bar chart, one series per y column:

```json
{
  "chart": {
    "type": "bar",
    "title": "Runs per day",
    "data": [
      {
        "day": "2026-11-10",
        "success": 42,
        "failure": 3
      },
      {
        "day": "2026-11-11",
        "success": 51,
        "failure": 1
      }
    ],
    "x": "day",
    "y": [
      "success",
      "failure"
    ],
    "stacked": true
  }
}
```

Pie chart (exactly one y column):

```json
{
  "chart": {
    "type": "pie",
    "data": [
      {
        "language": "python3",
        "scripts": 18
      },
      {
        "language": "bun",
        "scripts": 25
      }
    ],
    "x": "language",
    "y": "scripts"
  }
}
```

A chart and a table together:

```json
{
  "render_all": [
    {
      "chart": {
        "type": "line",
        "data": [
          {
            "hour": "10:00",
            "p95_ms": 120
          },
          {
            "hour": "11:00",
            "p95_ms": 180
          }
        ],
        "x": "hour",
        "y": "p95_ms",
        "y_label": "ms"
      }
    },
    {
      "table-row-object": [
        {
          "hour": "10:00",
          "p95_ms": 120,
          "jobs": 310
        },
        {
          "hour": "11:00",
          "p95_ms": 180,
          "jobs": 402
        }
      ]
    }
  ]
}
```
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall