Read Metrics

List and inspect metric definitions and aggregation logic in Lightdash.

3|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/yu-iskw/dbt-heros --skill read-metrics
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Read Metrics
Source: https://github.com/yu-iskw/dbt-heros/tree/main/plugins/lightdash-development/skills/read-metrics
Command: npx skills add https://github.com/yu-iskw/dbt-heros --skill read-metrics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users understand and identify existing metrics within a Lightdash project, facilitating informed data modeling and analysis.

Core Features & Use Cases

  • Metric Discovery: Lists all available metrics within a specified Lightdash project.
  • Inspection: Allows users to view the current aggregation logic and definition of metrics.
  • Use Case: Before adding a new metric, use this Skill to check if a similar metric already exists and understand its definition.

Quick Start

Use the read-metrics skill to list all available metrics in the current project.

Frequently Asked Questions about Read Metrics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list existing metrics in a Lightdash project?▼

To list existing metrics in a Lightdash project, you need to query the Lightdash semantic layer using the list_metrics MCP tool to discover all available metric definitions and their aggregation logic.

How do I check if a metric already exists in Lightdash before adding a new one?▼

To check if a metric exists in Lightdash before adding a new one, inspect the current project's metric definitions using the list_metrics MCP tool to review existing aggregation logic and avoid duplicate modeling.

What is the best way to inspect dbt metric definitions in a Lightdash semantic layer?▼

The best way to inspect dbt metric definitions in a Lightdash semantic layer is to query the metric metadata to view the current aggregation logic and definition for consistent analysis and modeling.

Do I need a specific MCP tool to discover Lightdash metrics?▼

Yes, you need access to the lightdash_tools__list_metrics MCP tool to discover and query metric metadata defined in the Lightdash semantic layer.

Can I use this to understand metric aggregation logic for dbt modeling?▼

Yes, you can use this to understand metric aggregation logic for dbt modeling by inspecting existing metric definitions in the Lightdash semantic layer, ensuring consistent analysis and informed data modeling.