By oxy-hq
Complete Oxy toolkit for Claude Code and Cursor: build semantic layers, create workflows, ETL pipelines, data apps, draft eval tests, diagnose and repair failures, and validate configurations
Build a complete Oxy analytics instance from scratch — semantic layer, workflows + agents, optional ETL pipeline, and executive dashboard app. Runs all 4 core skills in sequence. Use in a fresh oxy project directory.
Build Oxy semantic layer and vector embeddings
Evaluate all 4 oxy skills against rubrics using the current project's real database, then propose and apply improvements to each SKILL.md file.
Sync database metadata and schemas from configured databases
Run evaluation tests on agent or workflow files
Build and configure Oxy `.agentic.yml` files — multi-step FSM agents that ground questions in the semantic layer, generate SQL, execute it, and interpret results. Use when the user asks to create, edit, or troubleshoot an agentic analytics or app-builder agent, or to choose between `.agent.yml`, `.agentic.yml`, and `.workflow.yml`.
Build and edit Oxy data app YAML files (*.app.yml) that visualize data through tasks and displays. Use when users ask to create dashboards, data apps, reports, interactive analytics interfaces, or to add filters/dropdowns/date pickers/controls to an app. Helps define SQL/workflow/agent tasks, interactive controls, and render outputs as tables, charts, and markdown.
Build or extend ETL pipelines using DLT. Use when: (1) starting a new ETL project, (2) adding API connectors (Toast, Square, etc.), (3) adding spreadsheet/document ingestion, or (4) extending existing pipelines with new sources.
Evaluate the output of one of the 4 oxy instance-building skills (semantic-layer, workflow-builder, etl-builder, app-builder) against a rubric and propose specific improvements to the skill's SKILL.md. Use when the user asks to evaluate a skill, score skill output, or improve a skill based on test results.
Use when an Oxy agent is giving wrong, incomplete, or inconsistent answers — whether the user reports failing/flaky tests, shares a specific prompt with a bad response, says 'the agent isn't answering this correctly', 'this response is wrong', 'investigate why this doesn't work', 'tests are failing', 'fix this flaky test', 'the answer should be X but the agent says Y', 'debug this eval', 'make this test pass', or generally complains that their agent's output is unreliable. Also use when the user pastes test output JSON, trace data, or a prompt+response pair and wants it diagnosed and fixed. Diagnoses failures from `oxy test --output-json` results, observability traces, or user-reported prompt/response pairs, then makes targeted repairs to semantic layer files (views/topics) and agent system instructions — never weakens the tests.
Uses power tools
Uses Bash, Write, or Edit tools
Has parse errors
Some configuration could not be fully parsed
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
AI-powered assistance for building Oxy analytics projects. Includes skills for semantic layer development, workflow creation, ETL pipelines, and data app building.
Available for Claude Code (plugin) and Cursor (project rules).
# Install from marketplace
/plugin marketplace add oxy-hq/skills
/plugin install oxy-skills@oxy-hq
# Or use locally
claude --plugin-dir /path/to/oxy-template
Copy the project rules into your Oxy project:
# From this repo
./cursor/install.sh /path/to/your-oxy-project
# Or manually copy
cp cursor/rules/*.mdc /path/to/your-oxy-project/.cursor/rules/
See cursor/README.md for full setup instructions.
oxy-semantic-layer Builds semantic layer files (views and topics) for natural language analytics.
.databases/*.view.yml files with entities, dimensions, and measures*.topic.yml files to organize viewsoxy buildoxy-workflow-builder Creates data workflows, SQL queries, and AI agents following Oxy patterns.
*.workflow.yml and *.agent.yml filesoxy runoxy-etl-builder Builds ETL pipelines using DLT (data-load-tools) for loading data into warehouses.
etl/sources/, etl/runners/, and transform filesoxy-app-builder
Creates data apps (*.app.yml) - interactive dashboards combining tasks and visualizations.
oxy-test-drafter
Bootstraps and refines .test.yml eval files for Oxy agents and workflows.
oxy test --output-json and parses multi-run JSON tracesexpected strings| Command | Description |
|---|---|
/oxy:validate | Validate all Oxy configuration files |
/oxy:build | Build semantic layer and embeddings |
/oxy:sync | Sync database metadata and schemas |
/oxy:test | Run evaluation tests on agents/workflows |
config-validator Autonomous validator that checks Oxy YAML files for syntax errors, schema violations, and reference issues.
.claude-plugin/
├── plugin.json # Plugin manifest
└── marketplace.json # Marketplace metadata
skills/
├── oxy-semantic-layer/
│ ├── SKILL.md # Skill instructions for Claude
│ ├── README.md # User-facing documentation
│ ├── QUICK-REFERENCE.md
│ └── *.yml # Templates
├── oxy-workflow-builder/
│ ├── SKILL.md # Workflow skill instructions
│ ├── README.md # User documentation
│ ├── QUICK-REFERENCE.md
│ └── *-template.* # SQL, workflow, agent templates
├── oxy-etl-builder/
│ ├── SKILL.md # ETL skill instructions
│ ├── README.md # User documentation
│ ├── QUICK-REFERENCE.md
│ ├── playbook-*.md # Source-specific guides
│ ├── etl-style-guide.md
│ ├── warehouse-modeling.md
│ └── templates/ # Code templates
├── oxy-app-builder/
│ ├── SKILL.md # App builder skill instructions
│ ├── README.md # User documentation
│ ├── QUICK-REFERENCE.md
│ ├── templates/ # App templates
│ └── examples/ # Example prompts
└── oxy-test-drafter/
├── SKILL.md # Test drafter skill instructions
└── README.md # User documentation
commands/
├── validate.md
├── build.md
├── sync.md
└── test.md
agents/
└── config-validator.md # Autonomous agent instructions
cursor/ # Cursor IDE support
├── rules/
│ ├── oxy-core.mdc # Always-on core conventions
│ ├── oxy-semantic-layer.mdc
│ ├── oxy-workflow-builder.mdc
│ ├── oxy-etl-builder.mdc
│ └── oxy-app-builder.mdc
├── install.sh # Copy rules into a project
└── README.md # Cursor setup guide
oxy --version)config.ymlnpx claudepluginhub oxy-hq/skills --plugin oxy-skillsSemantic SQL compiler — compile .view.yml schema definitions into dialect-specific SQL. Unix-philosophy CLI designed as a tool-use interface for LLMs.
Explore, query, model, embed, and manage Omni Analytics through the REST API and embed SDK. Includes 9 skills, 3 specialized agents, and 3 context rules for model exploration, querying, model building, content browsing, content building, embedding, AI optimization, AI eval, and administration.
Skills for analytics engineering with dbt — building models, writing tests, querying the semantic layer, troubleshooting jobs, and more.
Semantic SQL compiler — compile .view.yml schema definitions into dialect-specific SQL. Unix-philosophy CLI designed as a tool-use interface for LLMs.
Spec-Driven Development framework for Data Engineering — 58 agents, 24 KB domains, 5-phase SDD workflow, 31 commands
Skills and tools powered by the Honeydew MCP that help coding agents query data and build semantic models
Quick insights from dlt pipeline data. Connect to a pipeline, profile tables, plan charts, and assemble marimo dashboards.