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.

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.

{"$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:

{
  "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):

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

A chart and a table together:

{
  "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: 197kUpdated 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