lightdash-api-discovery

Parse Lightdash API OpenAPI specs and summarize endpoints, schemas, and authentication.

1|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/yu-iskw/lightdash-tools --skill lightdash-api-discovery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lightdash-api-discovery
Source: https://github.com/yu-iskw/lightdash-tools/tree/main/.claude/skills/lightdash-api-discovery
Command: npx skills add https://github.com/yu-iskw/lightdash-tools --skill lightdash-api-discovery

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps you deeply understand the Lightdash API's structure, authentication, and available endpoints, enabling the correct implementation of a custom HTTP client.

Core Features & Use Cases

  • API Specification Discovery: Fetches and parses API documentation and OpenAPI specs.
  • Endpoint Summarization: Details methods, paths, parameters, and schemas for client implementation.
  • Authentication Guidance: Clarifies Personal Access Token (PAT) usage.
  • Recipe Integration: Identifies multi-step workflows and examples.
  • Use Case: When building a new service that needs to interact with Lightdash, use this Skill to gather all necessary details about the API endpoints, their request/response formats, and authentication methods.

Quick Start

Use the lightdash-api-discovery skill to find the API endpoints for managing projects and their associated data.

Frequently Asked Questions about lightdash-api-discovery

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

FAQPage Schema
How do I understand the Lightdash API specification for building a custom HTTP client?

To understand the Lightdash API specification for a custom HTTP client, parse the structured summaries of base URLs, endpoint definitions, parameter types, and request/response schemas for both v1 and v2.

How does authentication work when integrating with the Lightdash API?

Authentication for the Lightdash API works by using a Personal Access Token (PAT). The API discovery process clarifies PAT usage to ensure secure authorization for your custom HTTP client implementations.

What's the best way to discover Lightdash API endpoints and their request/response schemas?

The best way to discover Lightdash API endpoints and schemas is by parsing the official OpenAPI specifications. This provides detailed methods, paths, parameter types, and error shapes for both v1 and v2.

Can I use the Lightdash API documentation to generate a type-safe HTTP client?

Yes, you can use the Lightdash API documentation to generate a type-safe HTTP client. The API discovery process extracts structured summaries of API contracts, parameter types, and response schemas directly from the OpenAPI specs.

Do I need to reference the OpenAPI specification to understand Lightdash multi-step workflows?

You need to reference the OpenAPI specification to identify multi-step workflows and examples for Lightdash. This recipe integration helps map out complex endpoint interactions required for your service.