setup-runtime

Verifies and configures a dlthub workspace for dltHub Platform deployment.

Updated Jun 15, 2026
One-click install
npx skills add https://github.com/aminojagh/LLMZC --skill setup-runtime-aminojagh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup-runtime
Source: https://github.com/aminojagh/LLMZC/tree/main/05_02_dlt_workshop/.claude/skills/setup-runtime
Command: npx skills add https://github.com/aminojagh/LLMZC --skill setup-runtime-aminojagh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires dlt[hub].

What problem does it solve? Before deploying pipelines to dltHub Platform, your local workspace must meet several prerequisites: a Python project with pyproject.toml, a .dlt/.workspace file, the dlt[hub] dependency, platform authentication, and profile configuration files. This Skill walks through each check and fixes issues as they are found, so you do not hit cryptic failures later during deployment. ## Core Features & Use Cases - Python project verification: Confirms pyproject.toml exists and initializes one with uv init if missing. - Workspace initialization: Creates the .dlt/.workspace file via dlthub init, enabling profiles and the runtime CLI. - Dependency and login checks: Ensures dlt[hub] is installed with a pinned version and runs the dlthub login device-code OAuth flow plus workspace connect. - Use Case: You are deploying a dlt pipeline to dltHub Platform for the first time and another skill reports a missing .workspace file. Run this Skill to validate and repair the entire workspace setup step by step. ## Quick Start Verify my dlthub workspace is ready for dltHub Platform deployment and fix anything that is missing.

Frequently Asked Questions about setup-runtime

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

FAQPage Schema
How do I set up a dlthub workspace for dltHub Platform?▼

Run dlthub init to create the .dlt/.workspace file, ensure pyproject.toml exists, install dlt[hub] with uv add, then run dlthub login and dlthub workspace connect. This Skill walks through each check and fixes issues as found.

How do I fix a missing .dlt/.workspace file?▼

Run dlthub init, which creates .dlt/.workspace and prompts for a workspace name. Use dlthub init --name <workspace> to skip the prompt or dlthub init --dry-run to preview. As a fallback, manually create it with touch .dlt/.workspace.

How do I log in to dltHub Platform from the CLI?▼

Run dlthub login to start a device-code OAuth flow where you visit a URL and enter a code in the browser. Afterward, run dlthub workspace connect to select or create a workspace, which stores the workspace ID in config.toml under [runtime].

Why should I pin the dlt version when adding dlt[hub]?▼

Pin the exact installed version with == in pyproject.toml because uv add may downgrade pre-release versions of dlt. Verify installation first with uv pip show dlt and confirm the hub extra is present.

What files must exist in the .dlt directory before deployment?▼

At minimum you need .dlt/config.toml, .dlt/secrets.toml, and .dlt/.workspace. Profile-scoped files like dev.*, prod.*, and access.* are optional at this stage and are created later by the prepare-deployment step.