sigma-workbooks

sigma-workbooks is a cursor rule for Cursor from twells89/sigma-skills. It costs 160 tokens per session (9,136 once invoked), scanned A, original, Apache-2.0.

A guide for creating and changing Sigma workbooks, which are interactive data-analysis documents containing pages, charts, tables, controls, formulas, and key figures. It works with the JSON specification sent to Sigma’s workbook API.

In plain words
What is it for?
Use it to build or edit Sigma dashboards, including their layout, data sources, charts, tables, filters, formulas, and KPI displays.
Why use it?
It helps turn a workbook design into the structured format Sigma accepts and supports safe iteration as the workbook changes.

Cursor rule for Cursor

Written for Cursor: a Cursor rule (.mdc).

Needs its repository: it runs a file that does not travel with it, so clone the repository first. The line is ruby scripts/wb-rep.rb capabilities # list every kind.

Good fit Use it to build or edit Sigma dashboards, including their layout, data sources, charts, tables, filters, formulas, and KPI displays.

Compare 6 cursor rules from other repositories ↓
Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/twells89/sigma-skills
agentmods
npx agentmods add rules/twells89/sigma-skills/sigma-workbooks

Made for: Cursor.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for sigma-workbooks

README.md
[![agentmods](https://agentmods.dev/badge/rules/twells89/sigma-skills/sigma-workbooks/github.svg)](https://agentmods.dev/rules/twells89/sigma-skills/sigma-workbooks)
Your own site
<a href="https://agentmods.dev/rules/twells89/sigma-skills/sigma-workbooks"><img src="https://agentmods.dev/badge/rules/twells89/sigma-skills/sigma-workbooks/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for sigma-workbooks

Your own site · 80×15
<a href="https://agentmods.dev/rules/twells89/sigma-skills/sigma-workbooks"><img src="https://agentmods.dev/badge/rules/twells89/sigma-skills/sigma-workbooks.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 160 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 9,136 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00160 $0.09136
Opus 5.5 $0.00064 $0.03654
Sonnet 5.5 $0.00032 $0.01827
Haiku 4.5 $0.00016 $0.00914

Measured 22d ago against content hash 6698f631b383, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

sigma-workbooks scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 22d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -sfL https://assets.sigmacomputing.com/openapi/public-rest-api/sigma-computing-public-rest-api.json \
sigma-workbooks/generated/cursor/rules/sigma-workbooks.mdc · 496 lines

How it starts

The opening of the file, as written. The whole thing — 496 lines — stays where its author put it; the contents beside it link to each section on GitHub.

sigma-workbooks

Build, edit, and iterate on Sigma workbook specs — the JSON definition you POST to /v2/workbooks/spec, covering pages, layout, controls, charts, KPIs, tables, formulas, and sources. The Sigma OpenAPI is the source of truth for every shape and field; this skill adds navigation, style guidance, and proven recipes for effective dashboards and operational apps. Use when the user wants to construct a dashboard from a spec, generate a Sigma app (planning, approval, allocation, or exception), reproduce a screenshot/mockup/Claude design artifact as a native Sigma app, add or modify pages / elements / controls / formulas, validate a spec before submission, or work through the workbook spec lifecycle programmatically. Requires an SIGMA_API_TOKEN — obtain via the sigma-api skill first.

Installed runtime

When installed with scripts/install-into-project.sh, the complete runnable skill is copied to <project>/.sigma-skills/sigma-workbooks/ (project install) or ~/.sigma-skills/sigma-workbooks/ (global install). Resolve every relative scripts/, reference/, refs/, and docs/ path below from that runtime directory; cd there before running a command. The installer also copies sigma-api beside skills that need authentication.

Sigma Workbooks (Spec via REST API)

This skill helps you build effective Sigma workbooks by navigating the Sigma OpenAPI and applying style guidance + proven recipes beyond what the OpenAPI alone teaches.

Scope

The workbook spec — the JSON you POST to /v2/workbooks/spec defining pages, elements, sources, formulas, and layout. Layout supports grid placement plus responsive stack containers. Lifecycle around the workbook (embeds, grants, materialization schedules, bookmarks, sharing) is a separate API surface and out of scope here.

Sources of truth

Sigma's public API docs are an index at https://help.sigmacomputing.com/openapi.json that lists two canonical split specs (split from one large spec to fix compilation / out-of-memory errors — so the structure changed subtly). That index now serves an HTML page, not JSON (verified 2026-08-05) — it renders links to the two specs rather than returning a machine-readable list, so treat it as a human landing page and go straight to the two URLs below:

Read the full file on GitHub · 496 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 22d ago Changed · +3 lines 6698f631b383
  2. 24d ago Changed · +9 lines d17ce2ff5d1e
  3. 29d ago Changed a1531a6b948c
  4. 1mo ago Changed · +39 lines d993ae20088e
  5. 1mo ago Changed a74e9aa2c50b
  6. 1mo ago Changed · +17 lines 3d627da4ae91
  7. 2mo ago First seen · 428 lines · 160 tokens per session scan A b1bfa4c0d404

Subscribe to this mod's changes

sigma-workbooks is a cursor rule published in the GitHub repository twells89/sigma-skills (16 stars, last pushed 14d ago), licensed Apache-2.0. It adds 160 tokens to every session and 9,136 once invoked, about $0.0006 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.