2 skills · 4 min
Skills
Skill 2 of 2
Expert guidance for working with Dagster and the dg CLI.
3 minutes · 729 words · 6 sections
Install
npx skills add dagster-io/skills --skill dagster-expertnpx skills add dagster-io/skills/plugin marketplace add dagster-io/skillsThe first command installs just this skill, by the name in its SKILL.md; the second installs the whole repository.
Brief definitions only (see reference files for detailed examples):
When integrating with ANY external tool or service, read the Integration libraries index (opens in a new tab). This contains information about which integration libraries exist, and references on how to create new custom integrations for tools that do not have a published library.
dg CLI and the Dagster Plus MCP serverThere are two ways to interact with Dagster programmatically. Pick by where the work happens:
dg CLI — everything in the local project: adding definitions, scaffolding, validating, exploring project structure, and launching runs locally. Installed as part of the dagster-dg-cli package. If a relevant CLI command for a local task exists, always attempt to use it.dg api commands.dg api covers the same deployed resources as the MCP server from the command line, and remains the way to reach the parts the server does not expose. Before doing anything against a deployed Dagster Plus environment, read Dagster Plus API: General (opens in a new tab) — it covers how to choose between the two and how to fall back safely.
ONLY explore the existing project structure if it is strictly necessary to accomplish the user’s goal. In many cases, existing CLI tools will have sufficient understanding of the project structure, meaning listing and reading existing files is wasteful and unnecessary.
Almost all dg commands that return information have a --json flag that can be used to get the information in a machine-readable format. This should be preferred over the default table output unless you are directly showing the information to the user.
Projects typically use uv for dependency management, and it is recommended to use it for dg commands if possible:
uv run dg list defs
uv run dg launch --assets my_assetNEVER answer from memory or guess at CLI commands, APIs, or syntax. ALWAYS read the relevant reference file(s) from the Reference Index below before responding.
For every question, identify which reference file(s) are relevant using the index descriptions, read them, then answer based on what you read.
Expert guidance for working with Dagster and the dg CLI. ALWAYS use before doing any task that requires knowledge specific to Dagster, or that references assets, materialization, components, data tools or data pipelines. Common tasks may include creating a new project, adding new definitions, understanding the current project structure, answering general questions about the codebase (finding asset, schedule, sensor, component or job definitions), debugging issues, or providing deep information about a specific Dagster concept.
The verbatim description from this skill’s front matter — the string an agent matches on to decide whether to load it.
master, last pushed 21 September 2026.SKILL.md, not by matching a directory convention. 2 distinct layouts observed: plugins/dagster-expert/skills/*/SKILL.md, plugins/dagster/skills/*/SKILL.md..claude-plugin/marketplace.json by Dagster, declaring 2 plugins. It is read for editorial metadata only — never as the skill index, which is always the repository tree./dagster-io/skills.md, and each skill at its own URL..md173 files · 222 KB
Everything this skill ships beside its prose. All of it is set here, as subchapters of skill 2.
Documentation the agent loads on demand, rather than up front.
references/2 files · 9 KB
references/assets/4 files · 11 KB
references/automation/2 files · 6 KB
references/automation/declarative-automation/6 files · 31 KB
references/automation/sensors/3 files · 11 KB
references/cli/api/agent/3 files · 661 B
references/cli/api/alert-policy/3 files · 3 KB
references/cli/api/artifact/3 files · 1 KB
references/cli/api/5 files · 13 KB
references/cli/api/asset/7 files · 6 KBreferences/cli/api/code-location/5 files · 2 KB
references/cli/api/deployment/6 files · 2 KB
references/cli/api/issue/1 file · 5 KB
references/cli/api/organization/5 files · 2 KB
references/cli/api/run/6 files · 9 KB
references/cli/api/schedule/4 files · 1 KB
references/cli/api/secret/3 files · 874 B
references/cli/api/sensor/4 files · 1 KB
references/cli/6 files · 3 KB
references/cli/list/4 files · 1 KB
references/cli/plus/config/2 files · 668 B
references/cli/plus/create/1 file · 283 B
references/cli/plus/deploy/2 files · 2 KB
references/cli/plus/2 files · 1 KB
references/cli/plus/integrations/1 file · 1004 B
references/cli/plus/pull/1 file · 278 B
references/cli/scaffold/2 files · 3 KB
references/cli/utils/3 files · 2 KB
references/components/5 files · 29 KB
references/components/state-backed/2 files · 18 KB
references/deployment/1 file · 3 KB
references/integrations/dagster-airbyte/1 file · 173 B
references/integrations/dagster-airlift/1 file · 184 B
references/integrations/dagster-aws/1 file · 160 B
references/integrations/dagster-azure/1 file · 171 B
references/integrations/dagster-celery-docker/1 file · 193 B
references/integrations/dagster-celery-k8s/1 file · 194 B
references/integrations/dagster-celery/1 file · 164 B
references/integrations/dagster-census/1 file · 195 B
references/integrations/dagster-dask/1 file · 164 B
references/integrations/dagster-databricks/1 file · 179 B
references/integrations/dagster-datadog/1 file · 170 B
references/integrations/dagster-datahub/1 file · 181 B
references/integrations/dagster-dbt/7 files · 22 KBreferences/integrations/dagster-deltalake-pandas/1 file · 222 B
references/integrations/dagster-deltalake-polars/1 file · 222 B
references/integrations/dagster-deltalake/1 file · 208 B
references/integrations/dagster-dlt/1 file · 159 B
references/integrations/dagster-docker/1 file · 161 B
references/integrations/dagster-duckdb-pandas/1 file · 203 B
references/integrations/dagster-duckdb-polars/1 file · 203 B
references/integrations/dagster-duckdb-pyspark/1 file · 203 B
references/integrations/dagster-duckdb/1 file · 167 B
references/integrations/dagster-fivetran/1 file · 177 B
references/integrations/dagster-gcp-pandas/1 file · 216 B
references/integrations/dagster-gcp-pyspark/1 file · 217 B
references/integrations/dagster-gcp/1 file · 167 B
references/integrations/dagster-github/1 file · 171 B
references/integrations/dagster-great-expectations/1 file · 213 B
references/integrations/dagster-hightouch/1 file · 181 B
references/integrations/dagster-iceberg/1 file · 207 B
references/integrations/dagster-jupyter/1 file · 163 B
references/integrations/dagster-k8s/1 file · 165 B
references/integrations/dagster-looker/1 file · 152 B
references/integrations/dagster-mlflow/1 file · 181 B
references/integrations/dagster-msteams/1 file · 182 B
references/integrations/dagster-mysql/1 file · 157 B
references/integrations/dagster-omni/1 file · 146 B
references/integrations/dagster-openai/1 file · 156 B
references/integrations/dagster-pagerduty/1 file · 176 B
references/integrations/dagster-pandas/1 file · 171 B
references/integrations/dagster-pandera/1 file · 169 B
references/integrations/dagster-papertrail/1 file · 168 B
references/integrations/dagster-polars/1 file · 203 B
references/integrations/dagster-polytomic/1 file · 155 B
references/integrations/dagster-postgres/1 file · 171 B
references/integrations/dagster-powerbi/1 file · 154 B
references/integrations/dagster-prometheus/1 file · 172 B
references/integrations/dagster-pyspark/1 file · 169 B
references/integrations/dagster-sigma/1 file · 157 B
references/integrations/dagster-slack/1 file · 165 B
references/integrations/dagster-sling/1 file · 153 B
references/integrations/dagster-snowflake-pandas/1 file · 221 B
references/integrations/dagster-snowflake-polars/1 file · 221 B
references/integrations/dagster-snowflake-pyspark/1 file · 221 B
references/integrations/dagster-snowflake/1 file · 174 B
references/integrations/dagster-spark/1 file · 168 B
references/integrations/dagster-ssh/1 file · 149 B
references/integrations/dagster-tableau/1 file · 156 B
references/integrations/dagster-twilio/1 file · 159 B
references/integrations/dagster-wandb/1 file · 207 B
references/integrations/1 file · 10 KB
references/migration/2 files · 947 B