sigma-workbooks

sigma-workbooks is a cursor rule for Cursor from twells89/sigma-migration-skills. It costs 128 tokens per session (7,412 once invoked), scanned A, original, MIT.

A set of working rules for creating Sigma workbook specifications: JSON documents that define dashboard pages, charts, tables, controls, formulas, data sources, and layout.

In plain words
What is it for?
Use it when constructing, editing, validating, or submitting Sigma workbook specifications through the REST API.
Why use it?
It keeps programmatic workbook changes aligned with Sigma's API format and provides guidance for validating and arranging dashboards.

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 when constructing, editing, validating, or submitting Sigma workbook specifications through the REST API.

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-migration-skills
agentmods
npx agentmods add rules/twells89/sigma-migration-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-migration-skills/sigma-workbooks/github.svg)](https://agentmods.dev/rules/twells89/sigma-migration-skills/sigma-workbooks)
Your own site
<a href="https://agentmods.dev/rules/twells89/sigma-migration-skills/sigma-workbooks"><img src="https://agentmods.dev/badge/rules/twells89/sigma-migration-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-migration-skills/sigma-workbooks"><img src="https://agentmods.dev/badge/rules/twells89/sigma-migration-skills/sigma-workbooks.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 128 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 7,412 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.00128 $0.07412
Opus 5 $0.00064 $0.03706
Sonnet 5 $0.00026 $0.01482
Haiku 4.5 $0.00013 $0.00741

Measured 10d ago against content hash 977bd4604df0, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, 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 10d 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 \
plugins/sigma-authoring/skills/sigma-workbooks/generated/cursor/rules/sigma-workbooks.mdc · 390 lines

How it starts

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

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. Use when the user wants to construct a dashboard from a spec, 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.

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. 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:

  1. https://help.sigmacomputing.com/openapi/openapi/sigma-rest-api.json — the REST API: endpoint request/response shapes (workbooks, data models, members, connections, exports, materialization, …). Use for API calls.
  2. https://help.sigmacomputing.com/openapi/openapi/code-representation.json — the "code representation" (as-code) spec. Today it documents the data-model spec (/v2/dataModels/spec); use it for data-model element shapes.

Read the full file on GitHub · 390 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. 10d ago First seen · 390 lines · 128 tokens per session scan A 977bd4604df0

Subscribe to this mod's changes

sigma-workbooks is a cursor rule published in the GitHub repository twells89/sigma-migration-skills (15 stars, last pushed today), licensed MIT. It adds 128 tokens to every session and 7,412 once invoked, about $0.0006 per session on Opus 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.