[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ASQS7SXDV63D81YJFQSDTY":3,"skill-same:01M7ASQS7SXDV63D81YJFQSDTY":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},"01M7ASQS7SXDV63D81YJFQSDTY","cube-configure-agent",null,"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.","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-configure-agent\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: cube-configure-agent\ndescription: >-\n  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.\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# Configure the Cube agent\n\nMostly know-how rather than commands. Two CLI calls read the current state;\neverything else is writing markdown into the data model, which means the\ndev-mode workflow from `cube-build-model` applies.\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** (this plugin's\n`cube` server or the Cube connector), edit agent configuration like any other model file, with the\n`cube-build-model` loop: `cube:startDataModelEdit`, then `cube:readDataModelFile` and\n`cube:writeDataModelFile` under `agents\u002F`, then `cube:commitDataModelChanges`. Two\nthings the MCP path does better:\n\n- `cube:listDeployments` returns each deployment's agents.\n- `cube:chat` with the dev `branchName` runs Cube's agent against that branch's\n  rules, certified queries and skills. Ask the question that went wrong before\n  and after the change, in two separate chats — a chat stays on the branch it\n  started on.\n\nThe CLI's `cube agents skills` lists skill metadata in one call; over MCP,\nlist the files under `agents\u002Fskills\u002F`.\n\n## Preflight (CLI)\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## See what's configured\n\n```bash\ncube agents list \u003Cdeployment>\ncube agents skills \u003Cdeployment>\ncube agents skills \u003Cdeployment> --space \u003Cspace> --branch \u003Cbranch>\n```\n\n`cube agents skills` returns name, title and description — the metadata the\nagent matches on. It does not return the instructions; read those from the\nmodel files below.\n\n## Agent config lives in the data model\n\nUnder `agents\u002F` in the project — settings in YAML, everything else as\nmarkdown:\n\n```\nagents\u002F\n  rules\u002F               always-on instructions\n  certified_queries\u002F   trusted, named queries\n  skills\u002F              named multi-step workflows, run from the \u002F menu\n  config.yml           agent settings: llm, runtime, accessible_views, memory_mode\n```\n\nDeployments created before April 30, 2026 read these files only when\n`CUBE_CLOUD_AGENTS_CONFIG_ENABLED=true` is set — check with\n`cube variables list \u003Cdeployment>` or the MCP `cube:getDeploymentEnv`. Without\nit, writes here change nothing, silently. With several agents, rules,\ncertified queries and skills can also sit in per-space subdirectories such as\n`agents\u002Frules\u002F\u003Cspace>\u002F`.\n\nRead and write them with `cube data-model`, on a dev-mode branch:\n\n```bash\ncube data-model get \u003Cdeployment> agents\u002Frules\u002Frevenue-definitions.md\ncube data-model dev-mode \u003Cdeployment> main\ncube data-model put \u003Cdeployment> agents\u002Fskills\u002Fweekly-revenue-report.md --file .\u002Fskill.md --branch \u003Cdev-branch>\ncube data-model commit \u003Cdeployment> -m \"Add weekly revenue report skill\" --branch \u003Cdev-branch>\n```\n\nThe filename is the identity. `weekly-revenue-report.md` becomes the skill\n`weekly-revenue-report`. Because these are project files, they inherit the\nproject's git flow, review and access policies — a rule on a dev branch is\ntestable before it reaches anyone.\n\n## Which one to reach for\n\nThis is the judgement the skill exists to carry.\n\n| Use | When |\n| --- | --- |\n| **Rule** | A fact or constraint that should apply to *every* answer. \"Revenue excludes refunds.\" \"Never show data before 2024.\" Always in context, so keep them few and short. |\n| **Certified query** | A specific question with one correct query. Pins the answer so the agent stops re-deriving it. |\n| **Skill** | A repeatable multi-step workflow a person would otherwise re-type. \"Weekly revenue report\" — pull, break down, compare, summarize. |\n\nThe common mistake is writing a rule for something that should be a skill.\nRules are always loaded, so every rule is charged to every conversation; a\nlong list of them dilutes all of them. If the instruction only matters when\nsomeone asks for a particular thing, it is a skill.\n\n## Writing a good rule\n\n- State the fact, not the behaviour. \"Active user means logged in within 28\n  days\" beats \"always calculate active users correctly\".\n- One idea per rule. Split compound rules; they are easier to review and to\n  delete when they go stale.\n- Prefer fixing the model. A rule that explains what a badly named measure\n  means is a workaround — renaming the measure with `cube-build-model` fixes\n  it for every consumer, not just the agent.\n\n## Writing a good skill\n\nFrontmatter `title` and `description` (both required), markdown body for the\ninstructions. The `description` is what the agent matches free-text requests\nagainst, so write it the way a user would ask, not the way you would file it.\n\nNumber the steps. Say what the output should look like. If a step depends on\na certified query or a specific view, name it.\n\n## Diagnosing a bad answer\n\nWhen someone says the agent got something wrong, check in this order:\n\n1. **Is the model right?** A wrong measure produces a wrong answer no amount\n   of instruction fixes. Verify with `cube-run-query`.\n2. **Is the field exposed?** If it is not in a view, the agent cannot use it.\n3. **Is there a conflicting rule?** Read every rule, not just the relevant\n   one. Contradictory rules are common and the symptom is inconsistency.\n4. **Only then** add a rule or certified query.\n\nSkipping to step 4 is how deployments end up with thirty rules that paper\nover four model problems.\n\n## When something fails\n\n| Symptom | Cause |\n| --- | --- |\n| Skill does not appear | Not on the branch the chat is using, or the branch has not been built |\n| Write rejected | Not on a dev-mode branch — see `cube-build-model` |\n| `cube agents skills` returns nothing | No skills authored, or the wrong `--space`\u002F`--branch` |\n","# Configure the Cube agent\n\nMostly know-how rather than commands. Two CLI calls read the current state;\neverything else is writing markdown into the data model, which means the\ndev-mode workflow from `cube-build-model` applies.\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** (this plugin's\n`cube` server or the Cube connector), edit agent configuration like any other model file, with the\n`cube-build-model` loop: `cube:startDataModelEdit`, then `cube:readDataModelFile` and\n`cube:writeDataModelFile` under `agents\u002F`, then `cube:commitDataModelChanges`. Two\nthings the MCP path does better:\n\n- `cube:listDeployments` returns each deployment's agents.\n- `cube:chat` with the dev `branchName` runs Cube's agent against that branch's\n  rules, certified queries and skills. Ask the question that went wrong before\n  and after the change, in two separate chats — a chat stays on the branch it\n  started on.\n\nThe CLI's `cube agents skills` lists skill metadata in one call; over MCP,\nlist the files under `agents\u002Fskills\u002F`.\n\n## Preflight (CLI)\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## See what's configured\n\n```bash\ncube agents list \u003Cdeployment>\ncube agents skills \u003Cdeployment>\ncube agents skills \u003Cdeployment> --space \u003Cspace> --branch \u003Cbranch>\n```\n\n`cube agents skills` returns name, title and description — the metadata the\nagent matches on. It does not return the instructions; read those from the\nmodel files below.\n\n## Agent config lives in the data model\n\nUnder `agents\u002F` in the project — settings in YAML, everything else as\nmarkdown:\n\n```\nagents\u002F\n  rules\u002F               always-on instructions\n  certified_queries\u002F   trusted, named queries\n  skills\u002F              named multi-step workflows, run from the \u002F menu\n  config.yml           agent settings: llm, runtime, accessible_views, memory_mode\n```\n\nDeployments created before April 30, 2026 read these files only when\n`CUBE_CLOUD_AGENTS_CONFIG_ENABLED=true` is set — check with\n`cube variables list \u003Cdeployment>` or the MCP `cube:getDeploymentEnv`. Without\nit, writes here change nothing, silently. With several agents, rules,\ncertified queries and skills can also sit in per-space subdirectories such as\n`agents\u002Frules\u002F\u003Cspace>\u002F`.\n\nRead and write them with `cube data-model`, on a dev-mode branch:\n\n```bash\ncube data-model get \u003Cdeployment> agents\u002Frules\u002Frevenue-definitions.md\ncube data-model dev-mode \u003Cdeployment> main\ncube data-model put \u003Cdeployment> agents\u002Fskills\u002Fweekly-revenue-report.md --file .\u002Fskill.md --branch \u003Cdev-branch>\ncube data-model commit \u003Cdeployment> -m \"Add weekly revenue report skill\" --branch \u003Cdev-branch>\n```\n\nThe filename is the identity. `weekly-revenue-report.md` becomes the skill\n`weekly-revenue-report`. Because these are project files, they inherit the\nproject's git flow, review and access policies — a rule on a dev branch is\ntestable before it reaches anyone.\n\n## Which one to reach for\n\nThis is the judgement the skill exists to carry.\n\n| Use | When |\n| --- | --- |\n| **Rule** | A fact or constraint that should apply to *every* answer. \"Revenue excludes refunds.\" \"Never show data before 2024.\" Always in context, so keep them few and short. |\n| **Certified query** | A specific question with one correct query. Pins the answer so the agent stops re-deriving it. |\n| **Skill** | A repeatable multi-step workflow a person would otherwise re-type. \"Weekly revenue report\" — pull, break down, compare, summarize. |\n\nThe common mistake is writing a rule for something that should be a skill.\nRules are always loaded, so every rule is charged to every conversation; a\nlong list of them dilutes all of them. If the instruction only matters when\nsomeone asks for a particular thing, it is a skill.\n\n## Writing a good rule\n\n- State the fact, not the behaviour. \"Active user means logged in within 28\n  days\" beats \"always calculate active users correctly\".\n- One idea per rule. Split compound rules; they are easier to review and to\n  delete when they go stale.\n- Prefer fixing the model. A rule that explains what a badly named measure\n  means is a workaround — renaming the measure with `cube-build-model` fixes\n  it for every consumer, not just the agent.\n\n## Writing a good skill\n\nFrontmatter `title` and `description` (both required), markdown body for the\ninstructions. The `description` is what the agent matches free-text requests\nagainst, so write it the way a user would ask, not the way you would file it.\n\nNumber the steps. Say what the output should look like. If a step depends on\na certified query or a specific view, name it.\n\n## Diagnosing a bad answer\n\nWhen someone says the agent got something wrong, check in this order:\n\n1. **Is the model right?** A wrong measure produces a wrong answer no amount\n   of instruction fixes. Verify with `cube-run-query`.\n2. **Is the field exposed?** If it is not in a view, the agent cannot use it.\n3. **Is there a conflicting rule?** Read every rule, not just the relevant\n   one. Contradictory rules are common and the symptom is inconsistency.\n4. **Only then** add a rule or certified query.\n\nSkipping to step 4 is how deployments end up with thirty rules that paper\nover four model problems.\n\n## When something fails\n\n| Symptom | Cause |\n| --- | --- |\n| Skill does not appear | Not on the branch the chat is using, or the branch has not been built |\n| Write rejected | Not on a dev-mode branch — see `cube-build-model` |\n| `cube agents skills` returns nothing | No skills authored, or the wrong `--space`\u002F`--branch` |\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-configure-agent",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-configure-agent",{"tool":40,"command":41},"bunx","bunx skills add cube-js\u002Fcube-agent-skills --skill cube-configure-agent",{"tool":43,"command":44},"pnpm","pnpm dlx skills add cube-js\u002Fcube-agent-skills --skill cube-configure-agent","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fcube-js\u002Fcube-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcube-configure-agent\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},"01M7ASRWS98EN8SQEFQFB7RKSA","cube-run-query","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.","https:\u002F\u002Fgithub.com\u002Fcube-js\u002Fcube-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcube-run-query\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},"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":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},"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":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},"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":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},"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":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",[],[]]