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.