exploreomni / omni-cursor-plugin
★ 6A skill package that teaches your agent 8 capabilities — every one documented and browsable below, no GitHub required · by exploreomni.
Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.
Administer an Omni Analytics instance — manage connections, users, groups, user attributes, permissions, schedules, and schema refreshes via the REST API. Use…
1 file — installable on its own
Optimize your Omni Analytics model for Blobby, Omni's AI assistant — configure ai_context, ai_fields, sample_queries, and create AI-specific topic extensions.…
1 file — installable on its own
Create, update, and manage Omni Analytics documents and dashboards programmatically — document lifecycle, tiles, visualizations, filters, and layouts — using…
4 files — installable on its own
Find, browse, and organize content in Omni Analytics — dashboards, workbooks, folders, and labels — using the REST API. Use this skill whenever someone wants…
1 file — installable on its own
Embed Omni Analytics dashboards in external applications — URL signing, custom themes, iframe events, entity workspaces, and permission-aware content — using…
1 file — installable on its own
Create and edit Omni Analytics semantic model definitions — views, topics, dimensions, measures, relationships, and query views — using YAML through the Omni…
3 files — installable on its own
Discover and inspect Omni Analytics models, topics, views, fields, dimensions, measures, and relationships using the Omni REST API. Use this skill whenever…
1 file — installable on its own
Run queries against Omni Analytics' semantic layer using the REST API, interpret results, and chain queries for multi-step analysis. Use this skill whenever…
3 files — installable on its own
[!CAUTION] This repository is deprecated and no longer maintained. All skills, agents, and rules have been consolidated into
exploreomni/omni-agent-skills, which supports Claude Code, Cursor, OpenAI Codex, Snowflake Cortex Code, GitHub Copilot, Gemini CLI, and other skills.sh-compatible agents.
Migrating
Uninstall the old plugin and install the new one:
# Remove the old plugin
/remove-plugin omni-cursor-plugin
# Install the new unified plugin
/add-plugin https://github.com/exploreomni/omni-agent-skills.gitThe new repo includes the same 8 skills, 3 subagents, and 3 .mdc rules, plus additional skills like omni-ai-eval and omni-integrations.
The original README is preserved below for reference.
Omni Analytics Plugin for Cursor
A Cursor plugin that helps analytics engineers and data teams work with Omni Analytics programmatically through Omni's REST APIs.
Installation
From Cursor Marketplace
Search for "Omni Analytics" in the Cursor Marketplace or run:
/add-plugin omni-analyticsFrom Git URL
/add-plugin https://github.com/exploreomni/omni-cursor-plugin.gitSetup
After installation, set these environment variables:
export OMNI_BASE_URL="https://yourorg.omniapp.co"
export OMNI_API_KEY="your-api-key"API keys are created in Settings > API Keys (Organization Admin) or User Profile > Manage Account > Generate Token (Personal Access Token).
What's Included
Skills (8)
Skills activate automatically based on your request:
| Skill | Description |
|---|---|
| omni-model-explorer | Discover and inspect models, topics, views, fields, and relationships |
| omni-model-builder | Create and edit views, topics, dimensions, measures, and relationships in YAML |
| omni-query | Run queries against Omni's semantic layer and interpret results |
| omni-content-explorer | Find, browse, and organize dashboards, workbooks, and folders |
| omni-content-builder | Create, update, and manage documents and dashboards programmatically — lifecycle, tiles, filters, layouts |
| omni-ai-optimizer | Optimize your Omni model for Blobby (Omni's AI assistant) |
| omni-embed | Embed Omni dashboards in external applications — URL signing, themes, and postMessage events |
| omni-admin | Manage connections, users, groups, permissions, and schedules |
Subagents (3)
Specialized agents for complex multi-step workflows:
| Agent | Description |
|---|---|
| omni-analyst | Explores models, runs queries, and delivers insights |
| omni-modeler | Builds semantic models, writes YAML, and optimizes for AI |
| omni-admin-agent | Manages users, permissions, schedules, and connections |
Rules (3)
Always-available context applied when relevant:
| Rule | Description |
|---|---|
| omni-api-conventions | Auth headers, base URL patterns, error handling, pagination |
| omni-yaml-conventions | YAML file types, field syntax, dimension/measure patterns |
| omni-terminology | Maps business intelligence terms to Omni-specific vocabulary |
Usage
Just ask naturally — skills, subagents, and rules activate automatically:
"What topics are available in our Omni model?" → omni-model-explorer
"Run a query showing revenue by month" → omni-query
"Add a new dimension for customer tier to the users view" → omni-model-builder
"Find the dashboard about sales performance" → omni-content-explorer
"Set up dashboard filters for date range and region" → omni-content-builder
"Improve the AI context on our orders topic" → omni-ai-optimizer
"Give the marketing team access to the sales dashboard" → omni-adminFor complex workflows, invoke subagents directly:
@omni-analyst What are our top 10 products by revenue this quarter?
@omni-modeler Add customer lifetime value metrics to the users view
@omni-admin-agent Set up weekly PDF delivery of the executive dashboardRepository Structure
omni-cursor-plugin/
├── .cursor-plugin/
│ └── plugin.json ← Plugin manifest
├── skills/
│ ├── omni-model-explorer/SKILL.md
│ ├── omni-query/
│ │ ├── SKILL.md
│ │ └── references/
│ ├── omni-model-builder/
│ │ ├── SKILL.md
│ │ └── references/
│ ├── omni-content-explorer/SKILL.md
│ ├── omni-content-builder/
│ │ ├── SKILL.md
│ │ └── references/
│ ├── omni-ai-optimizer/SKILL.md
│ ├── omni-embed/SKILL.md
│ └── omni-admin/SKILL.md
├── agents/
│ ├── omni-analyst.md
│ ├── omni-modeler.md
│ └── omni-admin-agent.md
├── rules/
│ ├── omni-api-conventions.mdc
│ ├── omni-yaml-conventions.mdc
│ └── omni-terminology.mdc
├── README.md
└── LICENSEDocumentation
- Omni REST API Reference
- Omni Modeling Documentation
- Omni AI Optimization Guide
- Omni MCP Server (complementary — this plugin uses the REST API directly)
- Cursor Plugin Docs
Contributing
Contributions welcome! Please open an issue or PR.
License
Apache 2.0
Install the whole package (8 skills):
npx skills add https://github.com/exploreomni/omni-cursor-pluginOr install a single skill:
npx skills add https://github.com/exploreomni/omni-cursor-plugin --skill <name>Pick the skill name from the Skills tab — each entry there installs independently.