AI coding agents can help you build and maintain your Qyra semantic layer more efficiently. By installing Qyra skills, you enable these agents to understand your semantic layer structure and use the latest Qyra features correctly.

What are skills?

Skills are context files that teach AI coding agents about Qyra's YAML configuration, metrics, dimensions, and best practices. They're powered by agentskills.io and provide agents with the knowledge they need to:

• Generate correct YAML configurations for metrics and dimensions
• Follow Qyra naming conventions and best practices
• Understand table relationships and joins
• Use the latest Qyra features and syntax

Supported tools

Qyra skills work with popular AI coding assistants:

• Cursor - AI-powered code editor
• Claude Code - Anthropic's coding assistant
• Codex - OpenAI's code generation model
• Antigravity - AI development platform
• GitHub Copilot - GitHub's AI pair programmer (supports skills in .github/skills and .claude/skills directories). Learn more about Copilot agent skills.
• Other tools that support the skills format

Installing skills

Use the Qyra CLI to install skills for your preferred AI coding agent.

Prerequisites

• Qyra CLI installed

Install globally

Install skills globally to use them across all your projects (recommended, since the version of skills is tied to the version of the Qyra CLI, which is typically installed globally):

# Install globally for Claude (default)
qyra install-skills --global

# Install globally for Cursor
qyra install-skills --agent cursor --global

# Install globally for Codex
qyra install-skills --agent codex --global

Global skills are installed to your home directory (e.g., ~/.claude/skills/).

Install for your project

Install skills at the project level for team collaboration:

# Install for Claude (default)
qyra install-skills

# Install for Cursor
qyra install-skills --agent cursor

# Install for Codex
qyra install-skills --agent codex

This creates a skills directory at your git root:

• .claude/skills/ for Claude (also works with GitHub Copilot)
• .cursor/skills/ for Cursor
• .codex/skills/ for Codex

Install to a custom path

Specify a custom installation path:

qyra install-skills --path ./my-project

Install with the open agent skills ecosystem CLI

You can also install Qyra skills through the open agent skills ecosystem CLI, which works across any agent that supports the skills format:

npx skills add quanvio/qyra@developing-in-qyra

Using skills with your agent

Once installed, your AI coding agent automatically picks up the Qyra skills. You can then ask your agent to:

• Create new metrics and dimensions
• Generate YAML configurations for dbt models
• Fix validation errors in your semantic layer
• Refactor existing metric definitions
• Add joins between tables
• Create, edit, and synchronize organization data app themes as code

Example prompts

Create a revenue metric that sums the amount field from the orders table

Add a customer_segment dimension based on the lifetime_value field

Generate the Qyra YAML configuration for my users dbt model

Download our organization content, update the acme-brand data app theme with
the new logo and typography rules, upload it safely, and verify the CLI round trip

The agent uses the installed skills to generate correct, up-to-date Qyra configurations.

Keeping skills updated

Run qyra --version to check if your skills are up to date. This command returns the relevant skill update command based on where your skills are currently installed and whether they're outdated.

qyra --version

This ensures your agent always has the latest skill definitions with the newest Qyra features and best practices.