windmill-labs/windmill / system_prompts/auto-generated/skills/rich-results
rich-results
VerifiedMUST use when a script or flow should return a table, chart, markdown, image, file or map instead of plain JSON.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.9 KB |
SKILL.md
View on GitHub---
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
}
]
}
]
}
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |