From 6e8d7f736b60a3a2dffb69fe7e19578a945b9451 Mon Sep 17 00:00:00 2001 From: Oliver Laslett <11660098+owlas@users.noreply.github.com> Date: Tue, 10 Feb 2026 13:35:08 +0000 Subject: [PATCH 1/6] Update guides/developer/agent-skills.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/developer/agent-skills.mdx | 111 ++++++++++++++++++++++++++++++ 1 file changed, 111 insertions(+) create mode 100644 guides/developer/agent-skills.mdx diff --git a/guides/developer/agent-skills.mdx b/guides/developer/agent-skills.mdx new file mode 100644 index 00000000..66d7bd64 --- /dev/null +++ b/guides/developer/agent-skills.mdx @@ -0,0 +1,111 @@ +--- +title: "Agent skills" +description: "Use AI coding agents like Cursor, Claude Code, Codex, and Antigravity to build and maintain your Lightdash semantic layer." +--- + +AI coding agents can help you build and maintain your Lightdash semantic layer more efficiently. By installing Lightdash skills, you enable these agents to understand your semantic layer structure and use the latest Lightdash features correctly. + +## What are skills? + +Skills are context files that teach AI coding agents about Lightdash's YAML configuration, metrics, dimensions, and best practices. They're powered by [agentskills.io](https://agentskills.io) and provide agents with the knowledge they need to: + +- Generate correct YAML configurations for metrics and dimensions +- Follow Lightdash naming conventions and best practices +- Understand table relationships and joins +- Use the latest Lightdash features and syntax + +## Supported tools + +Lightdash 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 +- Other tools that support the skills format + +## Installing skills + +Use the Lightdash CLI to install skills for your preferred AI coding agent. + +### Prerequisites + +- [Lightdash CLI installed](/guides/cli/how-to-install-the-lightdash-cli) + +### Install for your project + +Install skills at the project level (recommended for team collaboration): + +```bash +# Install for Claude (default) +lightdash install-skills + +# Install for Cursor +lightdash install-skills --agent cursor + +# Install for Codex +lightdash install-skills --agent codex +``` + +This creates a skills directory at your git root: +- `.claude/skills/` for Claude +- `.cursor/skills/` for Cursor +- `.codex/skills/` for Codex + +### Install globally + +Install skills globally to use them across all your projects: + +```bash +# Install globally for Claude +lightdash install-skills --global + +# Install globally for Cursor +lightdash install-skills --agent cursor --global +``` + +Global skills are installed to your home directory (e.g., `~/.claude/skills/`). + +### Install to a custom path + +Specify a custom installation path: + +```bash +lightdash install-skills --path ./my-project +``` + +## Using skills with your agent + +Once installed, your AI coding agent automatically picks up the Lightdash 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 + +### 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 Lightdash YAML configuration for my users dbt model +``` + +The agent uses the installed skills to generate correct, up-to-date Lightdash configurations. + +## Keeping skills updated + +Re-run the install command to get the latest skills: + +```bash +lightdash install-skills +``` + +This downloads the newest skill definitions from the Lightdash repository, ensuring your agent knows about the latest features and best practices. From 04635f206bc99d16fc5118a164bafd9995456672 Mon Sep 17 00:00:00 2001 From: Oliver Laslett <11660098+owlas@users.noreply.github.com> Date: Tue, 10 Feb 2026 13:35:12 +0000 Subject: [PATCH 2/6] Delete guides/developer/agentic-coding.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/developer/agentic-coding.mdx | 111 ---------------------------- 1 file changed, 111 deletions(-) delete mode 100644 guides/developer/agentic-coding.mdx diff --git a/guides/developer/agentic-coding.mdx b/guides/developer/agentic-coding.mdx deleted file mode 100644 index 98d22354..00000000 --- a/guides/developer/agentic-coding.mdx +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: "Agentic coding" -description: "Use AI coding agents like Cursor, Claude Code, Codex, and Antigravity to build and maintain your Lightdash semantic layer." ---- - -AI coding agents can help you build and maintain your Lightdash semantic layer more efficiently. By installing Lightdash skills, you enable these agents to understand your semantic layer structure and use the latest Lightdash features correctly. - -## What are skills? - -Skills are context files that teach AI coding agents about Lightdash's YAML configuration, metrics, dimensions, and best practices. They're powered by [agentskills.io](https://agentskills.io) and provide agents with the knowledge they need to: - -- Generate correct YAML configurations for metrics and dimensions -- Follow Lightdash naming conventions and best practices -- Understand table relationships and joins -- Use the latest Lightdash features and syntax - -## Supported tools - -Lightdash 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 -- Other tools that support the skills format - -## Installing skills - -Use the Lightdash CLI to install skills for your preferred AI coding agent. - -### Prerequisites - -- [Lightdash CLI installed](/guides/cli/how-to-install-the-lightdash-cli) - -### Install for your project - -Install skills at the project level (recommended for team collaboration): - -```bash -# Install for Claude (default) -lightdash install-skills - -# Install for Cursor -lightdash install-skills --agent cursor - -# Install for Codex -lightdash install-skills --agent codex -``` - -This creates a skills directory at your git root: -- `.claude/skills/` for Claude -- `.cursor/skills/` for Cursor -- `.codex/skills/` for Codex - -### Install globally - -Install skills globally to use them across all your projects: - -```bash -# Install globally for Claude -lightdash install-skills --global - -# Install globally for Cursor -lightdash install-skills --agent cursor --global -``` - -Global skills are installed to your home directory (e.g., `~/.claude/skills/`). - -### Install to a custom path - -Specify a custom installation path: - -```bash -lightdash install-skills --path ./my-project -``` - -## Using skills with your agent - -Once installed, your AI coding agent automatically picks up the Lightdash 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 - -### 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 Lightdash YAML configuration for my users dbt model -``` - -The agent uses the installed skills to generate correct, up-to-date Lightdash configurations. - -## Keeping skills updated - -Re-run the install command to get the latest skills: - -```bash -lightdash install-skills -``` - -This downloads the newest skill definitions from the Lightdash repository, ensuring your agent knows about the latest features and best practices. From f4266803077b306704cd3134af27b1b3e77fa3f8 Mon Sep 17 00:00:00 2001 From: Oliver Laslett <11660098+owlas@users.noreply.github.com> Date: Tue, 10 Feb 2026 13:35:17 +0000 Subject: [PATCH 3/6] Update docs.json Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- docs.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs.json b/docs.json index 2cb4d473..45b5b9d5 100644 --- a/docs.json +++ b/docs.json @@ -144,7 +144,7 @@ "group": "Developer guides", "icon": "list-check", "pages": [ - "guides/developer/agentic-coding", + "guides/developer/agent-skills", "guides/developer/dbt-model-best-practices", "guides/developer/preview-projects", "guides/developer/dbt-write-back", From c09967087b8bdadd4a6e4603a7a793675158ebb7 Mon Sep 17 00:00:00 2001 From: Oliver Laslett <11660098+owlas@users.noreply.github.com> Date: Tue, 10 Feb 2026 13:35:22 +0000 Subject: [PATCH 4/6] Update docs.json Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- docs.json | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs.json b/docs.json index 45b5b9d5..e1e414fd 100644 --- a/docs.json +++ b/docs.json @@ -608,6 +608,10 @@ { "source": "/references/integrations/lightdash-yaml", "destination": "/guides/lightdash-yaml" + }, + { + "source": "/guides/developer/agentic-coding", + "destination": "/guides/developer/agent-skills" } ], From 60664c2de58d4c876373a8993393ad8bcb1a6471 Mon Sep 17 00:00:00 2001 From: Oliver Laslett <11660098+owlas@users.noreply.github.com> Date: Tue, 10 Feb 2026 13:41:46 +0000 Subject: [PATCH 5/6] Update get-started/develop-in-lightdash/install-skills.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- get-started/develop-in-lightdash/install-skills.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/get-started/develop-in-lightdash/install-skills.mdx b/get-started/develop-in-lightdash/install-skills.mdx index bbdd12ad..30ea296c 100644 --- a/get-started/develop-in-lightdash/install-skills.mdx +++ b/get-started/develop-in-lightdash/install-skills.mdx @@ -17,7 +17,7 @@ Install the Lightdash skills to enable AI-powered development with Claude Code o lightdash install-skills ``` -This command installs skills for Claude by default. For other AI coding agents, see the [detailed installation guide](/guides/developer/agentic-coding#installing-skills). +This command installs skills for Claude by default. For other AI coding agents, see the [detailed installation guide](/guides/developer/agent-skills#installing-skills). ## What you can build From 0cdc41a5b81e7cec414bccc38f690bcacd88550d Mon Sep 17 00:00:00 2001 From: Oliver Laslett <11660098+owlas@users.noreply.github.com> Date: Tue, 10 Feb 2026 13:41:47 +0000 Subject: [PATCH 6/6] Update get-started/develop-in-lightdash/install-skills.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- get-started/develop-in-lightdash/install-skills.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/get-started/develop-in-lightdash/install-skills.mdx b/get-started/develop-in-lightdash/install-skills.mdx index 30ea296c..c6c945a9 100644 --- a/get-started/develop-in-lightdash/install-skills.mdx +++ b/get-started/develop-in-lightdash/install-skills.mdx @@ -72,7 +72,7 @@ dashboards. Update all references and maintain the relationships. ## Next steps -For detailed installation options (global install, custom paths, different AI agents), see the [Agentic coding guide](/guides/developer/agentic-coding). +For detailed installation options (global install, custom paths, different AI agents), see the [Agent skills guide](/guides/developer/agent-skills). Once installed, you can use Claude Code or Cursor to build your Lightdash project conversationally without opening the UI.