all publishers

oxy-hq

@oxy-hq source repo

15 published skills

  1. ▌
    Oxy Evals · oxy-hq bundle
    Use when writing, running, or acting on evals for an Oxy agent — `.test.yml` files that run an `.agentic.yml` agent and score its answers with an LLM judge — and when the agent's answers are wrong. Triggers: "add a test", "write a test case", "write evals", "test this agent", "evaluate my agent", "bootstrap an eval suite", "fill in expected answers", "run the tests"; and the repair side: "tests are failing", "this test is flaky", "the agent's answer is wrong", "the answer should be X but the agent says Y", "debug this eval", "make this test pass", or pasted `oxy test --output-json` output or a prompt/response pair to diagnose. Drafts expected answers from observed runs, then diagnoses failures and repairs the agent's semantic model, context and instructions — never the test.
    0 installs
  2. ▌
    Oxy Custom Apps · oxy-hq bundle
    Use when building, debugging, reviewing, shipping, or verifying an Oxy custom-app bundle (a code-first React/Vite app served by Oxy at /customer-apps/<org>/<slug>/), including writing Oxy Functions, driving them from the UI, and checking a published app in the browser with the Playwright MCP server (no CI checks a published bundle). Covers the oxy-app.json contract, @oxy-hq/sdk and @oxy-hq/vite-plugin, where app data goes (ctx.airhouse, ctx.oltp, ctx.storage), pitfalls, performance guardrails, load speed and usage tracking (service worker, Activity tab, useTrackEvent), the self-serve oxyc publish ship flow, dev-<handle> sandboxes and workspace previews, how an AI agent gets its own short-lived credential (oxyc tokens create --sandbox-agent or --agent, never the engineer's oxyc login), and reading a deployment's live data with oxyc api and oxyc proxy (the oxy binary has no HTTP-API commands; every one of them is oxyc).
    0 installs
  3. ▌
    Oxy Airway Pipelines · oxy-hq
    Use when writing, reviewing, or debugging an Oxy Airway ELT pipeline (`.airway.yml`) — sources, the `kind` values Oxy actually wires, credentials, reset, rewind and retry — or when one misbehaves: "unsupported source kind", a pipeline that parses then fails at run time, credentials that do not resolve, a *pipeline* run landing `completed_with_errors` (an *automation* run with that status is `oxy-automations`), a schema that will not change, missing history after a backfill, or duplicate rows. Carries the traps the published pipeline reference does not.
    0 installs
  4. ▌
    Oxy Data Architecture · oxy-hq
    Use when deciding where an aggregate gets materialised — writing an `execute_sql` rollup, chaining one after an `airway` ingest step, choosing rollup vs semantic `pre_aggregations`, or whether raw rows must be retained — and on the symptoms: a dashboard that aggregates at query time, a load that wrote every row yet failed, preagg that cannot bucket to 15 minutes or join two views, or no "bronze"/"silver"/"gold" in the schema. Pipeline internals: `oxy-airway-pipelines`; view syntax: `oxy-semantic-modeling`.
    1 install
  5. ▌
    Oxy Semantic Modeling · oxy-hq bundle
    Use when writing, reviewing, or debugging an Oxy semantic model — `.view.yml` views, `.topic.yml` topics, measures, dimensions, entities, pre-aggregations (rollups), and the `meta:` freshness block — in a customer workspace, and when one misbehaves: a measure that vanishes after switching topics, "measure not found", a topic returning no rows or missing joins, a date filter failing with `TYPE_MISMATCH`, a rollup that never serves, or an agent reporting a partial day as a complete number. Carries the craft and the traps the reference docs do not.
    0 installs
  6. ▌
    Oxy CLI · oxy-hq
    Use when you need data out of an Oxy deployment — querying a customer's warehouse or semantic layer, reading threads/runs/apps/orgs, checking why an endpoint 4xxs, or reproducing a customer-reported bug against real data. Also when you need to know which endpoints exist or what body one takes, and (staff) when standing a new customer account up or checking which of its steps have landed. Triggers on "query the customer's data", "what does this API return", "debug this in production/dev", "which endpoint", "check the thread/run/app", "oxyc", "oxy api", "stand up a new customer", "new account setup", "oxyc bootstrap".
    0 installs
  7. ▌
    Oxy Repair · oxy-hq bundle
    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.
    5 installs
  8. ▌
    Oxy App Builder · oxy-hq bundle
    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.
    3 installs
  9. ▌
    Oxy Etl Builder · oxy-hq bundle
    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.
    3 installs
  10. ▌
    Oxy Poc Builder · oxy-hq bundle
    Build a sales POC package from first-meeting call notes. Use when the user shares discovery-call or first-meeting notes and asks to "build a POC", "spin up a demo", "set up the org in Oxygen", "make the proto app", or "create the deck" for a prospect. Produces an Oxygen (app.oxygen-hq.com) org with a "Staging" workspace containing two apps - a quick-win proto app and a timeline/pricing deck.
    4 installs
  11. ▌
    Oxy Test Drafter · oxy-hq bundle
    Use for ANY test or eval request involving an Oxy agent, workflow, or agentic workflow — 'add a test', 'create a test', 'write a test case', 'test this agent', 'run tests', 'add evals', 'evaluate my agent', 'create an evaluation', 'fill in expected answers', or 'bootstrap an eval suite'. Manages .test.yml eval files: scaffolding cases, running `oxy test --output-json`, parsing results, and drafting expected strings from observed outputs.
    3 installs
  12. ▌
    Oxy Semantic Layer · oxy-hq bundle
    Build and maintain Oxy semantic layer files (views and topics) for analytics. Use when the user asks to create, update, or validate Oxy semantic layers, view files, topic files, or needs help understanding database schemas for semantic layer creation.
    3 installs
  13. ▌
    Oxy Agentic Builder · oxy-hq bundle
    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`.
    3 installs
  14. ▌
    Oxy Workflow Builder · oxy-hq bundle
    Build Oxy workflows, SQL queries, and agents following best practices. Use when the user asks to create data pipelines, queries, or analysis agents. Enforces hierarchy - semantic queries first, then SQL/workflows, then agents.
    4 installs
  15. ▌
    Oxy Instance Skill Evaluator · oxy-hq
    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.
    5 installs