[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ASRWS98EN8SQEFQFB7RKSA":3,"skill-same:01M7ASRWS98EN8SQEFQFB7RKSA":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7ASRWS98EN8SQEFQFB7RKSA","cube-run-query",null,"Run queries against a Cube deployment's semantic layer and interpret the results — through the Cube MCP tools when they are connected, or the Cube CLI from a terminal. Use whenever someone wants numbers out of Cube — pull a metric, check a total, compare periods, verify that a measure returns what it should, sanity-check a model change. Triggers on \"how many\", \"what's the total\", \"show me revenue by month\", \"did that measure work\", \"what's our MoM growth\", \"pull the numbers for\", and any request to verify a model change against real data. To find out what is queryable first use cube-explore-model; to change the model use cube-build-model; to save a result as a report or dashboard use cube-build-content.","cube-js\u002Fcube-agent-skills","cube-js","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F52467369?v=4","01M7ASPXD7T6SBZM632VQRFBJM","Cube","01M7ASPXDVXSVY911K7DAMGEWQ",4,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fcube-js\u002Fcube-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcube-run-query\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: cube-run-query\ndescription: Run queries against a Cube deployment's semantic layer and interpret the results — through the Cube MCP tools when they are connected, or the Cube CLI from a terminal. Use whenever someone wants numbers out of Cube — pull a metric, check a total, compare periods, verify that a measure returns what it should, sanity-check a model change. Triggers on \"how many\", \"what's the total\", \"show me revenue by month\", \"did that measure work\", \"what's our MoM growth\", \"pull the numbers for\", and any request to verify a model change against real data. To find out what is queryable first use cube-explore-model; to change the model use cube-build-model; to save a result as a report or dashboard use cube-build-content.\nlicense: Apache-2.0\ncompatibility: Needs the Cube MCP server (bundled in the Cube plugin, or the Cube connector) or the Cube CLI, and network access to Cube Cloud.\n---\n\n# Run a query against Cube\n\n## Choose the path\n\nCube MCP tools are written `cube:\u003Ctool>` below: the `cube` server this plugin\nbundles. Through the Cube connector, the same tools carry the connector's name.\n\n**If the Cube MCP tools are available, use them.** They come from this\nplugin's `cube` server or the Cube connector — look for `cube:searchDataModel`,\n`cube:runQuery` and `cube:chat`. They need no install or login step, and every call runs\nas the signed-in user, so row-level security applies exactly as in the UI.\n\n- **A specific number:** `cube:searchDataModel` to find the view and the exact\n  member names, then `cube:runQuery` with Cube SQL —\n  `SELECT status, MEASURE(count) FROM orders_view GROUP BY 1`. Never guess a\n  member name.\n- **An open-ended question** (\"why did signups drop in March\"): `cube:chat`, which\n  runs Cube's own agent over the governed model and existing reports. Give the\n  user the `cubeChatUrl` it returns so they can continue in Cube.\n- **Another deployment:** `cube:listDeployments`, then pass its `deploymentId`.\n- **A dev branch:** pass the same `branchName` to `cube:searchDataModel` and\n  `cube:runQuery`, so the members you find are the ones the query sees.\n- **More than 100 rows:** page `cube:runQuery` with `offset` until `hasMore` is\n  false.\n\nUse the CLI path below when the MCP tools are not connected, or in a script or\nCI job. [Interpreting results](#interpreting-results) applies to both paths.\n\n## CLI path\n\nQuerying steps outside the CLI. `cube api` is bound to Cube's console API\nand cannot reach a deployment's query endpoint, so querying is two CLI calls\nto get a URL and a token, then a direct request to the deployment.\n\n### Preflight\n\n```bash\ncommand -v cube >\u002Fdev\u002Fnull || echo \"Cube CLI not installed: curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fcube-js\u002Fcube\u002Fmaster\u002Finstall-cli.sh | sh\"\ncube whoami || echo \"Not authenticated. Interactive: cube login. Headless: set CUBE_API_URL + CUBE_API_KEY.\"\ncube context list\n```\n\n`jq` and `curl` are also required here, unlike every other skill in this\nplugin. Check for them and say so if they are missing.\n\n### Get the endpoint and a token\n\n```bash\nDEPLOYMENT=\u003Cid>\nURL=$(cube deployments get \"$DEPLOYMENT\" --json | jq -r .deploymentUrl)\nTOKEN=$(cube deployments token \"$DEPLOYMENT\")\n```\n\n`cube deployments token` prints the Cube API token on its own; add `--json`\nif you want the wrapping object. The token carries the calling user's\nsecurity context, so row-level security applies exactly as it would in the\nUI — a query here returns what *that user* is allowed to see, not everything.\n\n### Know what you can query first\n\nDo not guess member names. Ask the compiled model:\n\n```bash\ncube meta --selectors '[{\"type\":\"cube\",\"deploymentId\":'\"$DEPLOYMENT\"',\"environment\":\"production\"}]'\n```\n\nMembers are `Cube.member` or `View.member`. A dimension that exists on a cube\nbut is not exposed in a view is not queryable through that view — `cube meta`\nis what tells you which is which.\n\n### Run it\n\n```bash\ncurl -s \"$URL\u002Fcubejs-api\u002Fv1\u002Fload\" \\\n  -H \"Authorization: $TOKEN\" \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\"query\":{\n        \"measures\":[\"Orders.count\",\"Orders.totalRevenue\"],\n        \"dimensions\":[\"Orders.status\"],\n        \"timeDimensions\":[{\"dimension\":\"Orders.createdAt\",\"granularity\":\"month\",\"dateRange\":\"Last 6 months\"}],\n        \"limit\":100\n      }}' | jq\n```\n\nQuery shape, in the order you usually need it:\n\n- `measures` — the numbers. Always fully qualified.\n- `dimensions` — what to break down by.\n- `timeDimensions` — `dimension` plus `granularity` (`day`\u002F`week`\u002F`month`\u002F…)\n  and `dateRange`, which accepts natural ranges like `\"Last 30 days\"` or an\n  explicit `[\"2026-01-01\",\"2026-06-30\"]`.\n- `filters` — `[{\"member\":\"Orders.status\",\"operator\":\"equals\",\"values\":[\"paid\"]}]`.\n- `order`, `limit`.\n\nThe response carries `data` plus `annotation`, which holds the human titles\nand formats for each member. Use `annotation` when presenting results — it is\nwhere a measure's display name and unit live.\n\n## Interpreting results\n\n- **Report the number, then how it was derived.** Which measure, which range,\n  which filters. A number without its query is not checkable.\n- **An empty `data` array is a result, not an error.** Say the query succeeded\n  and returned no rows; do not retry with a different query and present that\n  instead without saying you changed it.\n- **Never fill in a value you did not receive.** If the query failed, report\n  the error.\n\n## Verifying a model change\n\nThe common case after `cube-build-model`: query the new measure on the dev\nbranch before merging. Over MCP, pass the dev `branchName` to\n`cube:searchDataModel` and `cube:runQuery`. With the CLI, `$URL\u002Fcubejs-api\u002Fv1\u002Fload`\nalways answers from production; a dev branch has its own endpoint under the\nsame deployment URL, used with the same token:\n\n```bash\ncube deployments build-status \"$DEPLOYMENT\" --branch \u003Cdev-branch> --wait\ncurl -s \"$URL\u002Fdev-mode\u002F\u003Cdev-branch>\u002Fcubejs-api\u002Fv1\u002Fload\" -H \"Authorization: $TOKEN\" ...\n```\n\nPoint `cube meta` at the branch the same way, with `\"environment\":\"\u003Cdev-branch>\"`.\n\n## When something fails\n\n| Symptom | Cause |\n| --- | --- |\n| `deploymentUrl` is null | The deployment has never finished a build; check `cube deployments build-status` |\n| 401 from the load endpoint | Token expired — they are short-lived, just mint another |\n| `Member not found` | Wrong name or not exposed in that view — re-check `cube meta`, do not guess a variant |\n| `{\"error\":\"Continue wait\"}` | The query is still running — send the same request again until data comes back. Tell the user if it keeps going past a minute or two |\n","# Run a query against Cube\n\n## Choose the path\n\nCube MCP tools are written `cube:\u003Ctool>` below: the `cube` server this plugin\nbundles. Through the Cube connector, the same tools carry the connector's name.\n\n**If the Cube MCP tools are available, use them.** They come from this\nplugin's `cube` server or the Cube connector — look for `cube:searchDataModel`,\n`cube:runQuery` and `cube:chat`. They need no install or login step, and every call runs\nas the signed-in user, so row-level security applies exactly as in the UI.\n\n- **A specific number:** `cube:searchDataModel` to find the view and the exact\n  member names, then `cube:runQuery` with Cube SQL —\n  `SELECT status, MEASURE(count) FROM orders_view GROUP BY 1`. Never guess a\n  member name.\n- **An open-ended question** (\"why did signups drop in March\"): `cube:chat`, which\n  runs Cube's own agent over the governed model and existing reports. Give the\n  user the `cubeChatUrl` it returns so they can continue in Cube.\n- **Another deployment:** `cube:listDeployments`, then pass its `deploymentId`.\n- **A dev branch:** pass the same `branchName` to `cube:searchDataModel` and\n  `cube:runQuery`, so the members you find are the ones the query sees.\n- **More than 100 rows:** page `cube:runQuery` with `offset` until `hasMore` is\n  false.\n\nUse the CLI path below when the MCP tools are not connected, or in a script or\nCI job. [Interpreting results](#interpreting-results) applies to both paths.\n\n## CLI path\n\nQuerying steps outside the CLI. `cube api` is bound to Cube's console API\nand cannot reach a deployment's query endpoint, so querying is two CLI calls\nto get a URL and a token, then a direct request to the deployment.\n\n### Preflight\n\n```bash\ncommand -v cube >\u002Fdev\u002Fnull || echo \"Cube CLI not installed: curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fcube-js\u002Fcube\u002Fmaster\u002Finstall-cli.sh | sh\"\ncube whoami || echo \"Not authenticated. Interactive: cube login. Headless: set CUBE_API_URL + CUBE_API_KEY.\"\ncube context list\n```\n\n`jq` and `curl` are also required here, unlike every other skill in this\nplugin. Check for them and say so if they are missing.\n\n### Get the endpoint and a token\n\n```bash\nDEPLOYMENT=\u003Cid>\nURL=$(cube deployments get \"$DEPLOYMENT\" --json | jq -r .deploymentUrl)\nTOKEN=$(cube deployments token \"$DEPLOYMENT\")\n```\n\n`cube deployments token` prints the Cube API token on its own; add `--json`\nif you want the wrapping object. The token carries the calling user's\nsecurity context, so row-level security applies exactly as it would in the\nUI — a query here returns what *that user* is allowed to see, not everything.\n\n### Know what you can query first\n\nDo not guess member names. Ask the compiled model:\n\n```bash\ncube meta --selectors '[{\"type\":\"cube\",\"deploymentId\":'\"$DEPLOYMENT\"',\"environment\":\"production\"}]'\n```\n\nMembers are `Cube.member` or `View.member`. A dimension that exists on a cube\nbut is not exposed in a view is not queryable through that view — `cube meta`\nis what tells you which is which.\n\n### Run it\n\n```bash\ncurl -s \"$URL\u002Fcubejs-api\u002Fv1\u002Fload\" \\\n  -H \"Authorization: $TOKEN\" \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\"query\":{\n        \"measures\":[\"Orders.count\",\"Orders.totalRevenue\"],\n        \"dimensions\":[\"Orders.status\"],\n        \"timeDimensions\":[{\"dimension\":\"Orders.createdAt\",\"granularity\":\"month\",\"dateRange\":\"Last 6 months\"}],\n        \"limit\":100\n      }}' | jq\n```\n\nQuery shape, in the order you usually need it:\n\n- `measures` — the numbers. Always fully qualified.\n- `dimensions` — what to break down by.\n- `timeDimensions` — `dimension` plus `granularity` (`day`\u002F`week`\u002F`month`\u002F…)\n  and `dateRange`, which accepts natural ranges like `\"Last 30 days\"` or an\n  explicit `[\"2026-01-01\",\"2026-06-30\"]`.\n- `filters` — `[{\"member\":\"Orders.status\",\"operator\":\"equals\",\"values\":[\"paid\"]}]`.\n- `order`, `limit`.\n\nThe response carries `data` plus `annotation`, which holds the human titles\nand formats for each member. Use `annotation` when presenting results — it is\nwhere a measure's display name and unit live.\n\n## Interpreting results\n\n- **Report the number, then how it was derived.** Which measure, which range,\n  which filters. A number without its query is not checkable.\n- **An empty `data` array is a result, not an error.** Say the query succeeded\n  and returned no rows; do not retry with a different query and present that\n  instead without saying you changed it.\n- **Never fill in a value you did not receive.** If the query failed, report\n  the error.\n\n## Verifying a model change\n\nThe common case after `cube-build-model`: query the new measure on the dev\nbranch before merging. Over MCP, pass the dev `branchName` to\n`cube:searchDataModel` and `cube:runQuery`. With the CLI, `$URL\u002Fcubejs-api\u002Fv1\u002Fload`\nalways answers from production; a dev branch has its own endpoint under the\nsame deployment URL, used with the same token:\n\n```bash\ncube deployments build-status \"$DEPLOYMENT\" --branch \u003Cdev-branch> --wait\ncurl -s \"$URL\u002Fdev-mode\u002F\u003Cdev-branch>\u002Fcubejs-api\u002Fv1\u002Fload\" -H \"Authorization: $TOKEN\" ...\n```\n\nPoint `cube meta` at the branch the same way, with `\"environment\":\"\u003Cdev-branch>\"`.\n\n## When something fails\n\n| Symptom | Cause |\n| --- | --- |\n| `deploymentUrl` is null | The deployment has never finished a build; check `cube deployments build-status` |\n| 401 from the load endpoint | Token expired — they are short-lived, just mint another |\n| `Member not found` | Wrong name or not exposed in that view — re-check `cube meta`, do not guess a variant |\n| `{\"error\":\"Continue wait\"}` | The query is still running — send the same request again until data comes back. Tell the user if it keeps going past a minute or two |\n",{"name":5,"license":15,"description":7,"compatibility":24},"Needs the Cube MCP server (bundled in the Cube plugin, or the Cube connector) or the Cube CLI, and network access to Cube Cloud.","main","5e5ef13c40f3bfc101d575b568b5c5a3447d6fcb","skills\u002Fcube-run-query",0,"https:\u002F\u002Fgithub.com\u002Fcube-js\u002Fcube-agent-skills","https:\u002F\u002Fgithub.com\u002Fcube-js","https:\u002F\u002Fcube.dev","The Semantic Layer for building data apps","2026-10-01 05:18:35",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add cube-js\u002Fcube-agent-skills --skill cube-run-query",{"tool":40,"command":41},"bunx","bunx skills add cube-js\u002Fcube-agent-skills --skill cube-run-query",{"tool":43,"command":44},"pnpm","pnpm dlx skills add cube-js\u002Fcube-agent-skills --skill cube-run-query","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fcube-js\u002Fcube-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcube-run-query\u002FSKILL.md",true,[],[49,56,63,70,77,84],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7ASRMCKWK6CMRRTE8XJ9R4W","cube-explore-model","Search and inspect a Cube semantic model — cubes, views, measures, dimensions, joins, and the files they live in — through the Cube MCP tools or the Cube CLI. Use whenever someone wants to know what data is available in Cube, where a metric is defined, which cube a field belongs to, how two cubes join, or what a change would affect. Triggers on \"what can I query\", \"what measures do we have\", \"where is revenue defined\", \"show me the data model\", \"what's in this deployment\", \"which cube has customer email\", and impact questions like \"what breaks if I rename this\". Read the model with this skill before changing it. To edit the model use cube-build-model; to run a query and get numbers back use cube-run-query; to browse workbooks, dashboards and reports use cube-explore-content.","https:\u002F\u002Fgithub.com\u002Fcube-js\u002Fcube-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcube-explore-model\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7ASRDJTX19A2PT8JZ11TNQ4","cube-explore-content","Find and inspect saved content in a Cube workspace — workbooks, dashboards, reports, folders and scheduled notifications — using the Cube CLI, or the Cube MCP tools for content you already have a link to. Use whenever someone wants to know what already exists rather than build something new: locate a dashboard, list reports, see what a report queries, find who a notification goes to, or check what saved content references a model field before renaming it. Triggers on \"what dashboards do we have\", \"find the revenue report\", \"where is that workbook\", \"what's in this folder\", \"who gets this scheduled report\", \"is anything using this field\". To create or edit content use cube-build-content; to inspect the semantic model itself use cube-explore-model.","https:\u002F\u002Fgithub.com\u002Fcube-js\u002Fcube-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcube-explore-content\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7ASR6TH7HA1PQ7Z3DXPZ2B1","cube-embed","Set up and debug Cube embedded analytics — embed sessions, embed tokens, embeddable dashboards and embed tenants — using the Cube CLI. Use whenever someone is shipping Cube analytics inside their own product: mint a session for an end user, enable a dashboard for embedding, set up multi-tenant isolation so each customer sees only their data, or debug why an embedded view is empty or unauthorized. Triggers on \"embed this dashboard\", \"embedded analytics\", \"our customers need to see\", \"multi-tenant analytics\", \"the iframe is blank\", \"embed token\", \"sign the embed URL\", \"customer-facing dashboard\". For internal access control use cube-admin; for the dashboards themselves use cube-build-content.","https:\u002F\u002Fgithub.com\u002Fcube-js\u002Fcube-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcube-embed\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7ASR0E40HQ3H7DXY9N795H2","cube-deploy","Manage Cube deployments and their lifecycle — create deployments, deploy a project, check build status, manage environments and environment variables, connect a GitHub repo, and tail logs — using the Cube CLI. Use whenever someone wants to ship, configure or debug a deployment rather than change the model inside one. Triggers on \"deploy this\", \"did the build pass\", \"why did the build fail\", \"set an environment variable\", \"create a deployment\", \"connect our repo\", \"show me the logs\", \"what regions are available\", \"the deployment is down\". To change model files use cube-build-model; for users and access use cube-admin.","https:\u002F\u002Fgithub.com\u002Fcube-js\u002Fcube-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcube-deploy\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7ASQS7SXDV63D81YJFQSDTY","cube-configure-agent","Inspect and tune Cube's in-product AI agent — its rules, certified queries and Agent Skills — by authoring markdown in the semantic model, through the Cube MCP tools or the Cube CLI. Use whenever someone wants the Cube agent to answer better: teach it a business definition, stop it making a recurring mistake, certify a trusted query, capture a repeatable workflow as a skill, or find out why it answered the way it did. Triggers on \"the agent keeps getting X wrong\", \"teach the agent that\", \"make the agent always\", \"add a certified query\", \"create an agent skill\", \"why did the agent say that\", \"what rules does the agent have\". To change the underlying model use cube-build-model; to explore what is queryable use cube-explore-model.","https:\u002F\u002Fgithub.com\u002Fcube-js\u002Fcube-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcube-configure-agent\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7ASQH58PKK3XQK05YA5532H","cube-build-model","Author and change a Cube semantic model — add or edit cubes, views, measures, dimensions, joins and pre-aggregations in YAML — on a dev-mode branch through the Cube MCP tools or the Cube CLI, then commit and build. Use whenever someone wants to add a metric, define a measure or dimension, create a cube or view, join two cubes, fix a model error, rename a field, or expose a field to business users. Triggers on \"add a metric\", \"define revenue\", \"create a view for\", \"expose this field\", \"join orders to customers\", \"fix the model\", \"add a pre-aggregation\". Read the model first with cube-explore-model. To run a query against the result use cube-run-query; to deploy or check build status use cube-deploy.","https:\u002F\u002Fgithub.com\u002Fcube-js\u002Fcube-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcube-build-model\u002FSKILL.md",[],[]]