jamiedemaria
acfb27f7b3
This PR does two operations that result in a lot of files moving without content changes: 1. rename the `dagster-expert` plugin to `dagster`. See this slack discussion for context https://prefecthq.slack.com/archives/C0BQK1ESGP9/p1788378613868929 2. moves all plugins under the `plugins` directory rather than `skills`. Having plugins under `skills` was confusing To support the plugin rename i've kept the `dagster-expert` plugin with a stub `dagster-expert` skill. Users who have the `dagster-expert` skill installed and update it will get a message to upgrade to the `dagster` plugin whenever they invoke the `dagster-expert` skill. If we were to remove the `dagster-expert` plugin entirely, users would get a pretty opaque error when they try to update the plugin. We can remove the `dagster-expert` plugin entirely in a few weeks Internal-RevId: b4b8788699d8a03b7c8a03fb632e0ca04af72fb1
5.1 KiB
Dagster Skills
AI assistant skills for building workflows and data pipelines using Dagster. It bundles the dagster-expert skill for authoring pipelines and the Dagster+ MCP server for access to your Dagster+ deployment.
Compatible with Claude Code, Cursor, OpenCode, OpenAI Codex, Pi, and other Agent Skills-compatible tools.
Installation
Claude Code
Install using the Claude plugin marketplace:
/plugin marketplace add dagster-io/skills
/plugin install dagster@dagster
/dagster-expert "What's an asset?"
The plugin includes the
Dagster+ MCP server, giving the skill direct
access to your deployed organization: runs, assets, deployments, code locations, alert policies,
Issues, and insights metrics. Run /mcp to authenticate.
/mcp
# authenticate dagster-plus
Fetch the run logs for the most recent run failure.
The MCP URL points at the US region by default. If your organization is in the EU region, set the following environment variable before launching Claude Code:
export DAGSTER_CLOUD_MCP_URL=https://mcp.agent.eu.dagster.cloud/mcp
Using npx skills
Install using the npx skills command-line:
npx skills add dagster-io/skills
Manual Installation
See full instructions...
Clone the repository and copy skills to your tool's skills directory:
OpenCode:
git clone https://github.com/dagster-io/skills.git
cp -r skills/plugins/dagster/skills/* ~/.config/opencode/skill/
OpenAI Codex:
git clone https://github.com/dagster-io/skills.git
cp -r skills/plugins/dagster/skills/* ~/.codex/skills/
Pi Agent:
git clone https://github.com/dagster-io/skills.git
cp -r skills/plugins/dagster/skills/* ~/.pi/agent/skills/
Upgrading from dagster-expert
The Dagster skill now ships in a plugin named dagster rather than dagster-expert. The skill
itself is unchanged and is still invoked with /dagster-expert.
dagster-expert remains installable for now, but has become a stub that carries no Dagster guidance and only points here. To migrate:
/plugin install dagster@dagster
/plugin uninstall dagster-expert
If you install dagster without uninstalling dagster-expert, two plugins
provide a skill named dagster-expert and the deprecated stub may be used instead of the real one.
The dagster-expert plugin will be removed in a future release. After that, installations of it
report Plugin dagster-expert not found in marketplace dagster and stop loading.
Skills
dagster-expert
Expert guidance for building production-quality Dagster projects, covering CLI commands, asset patterns, automation strategies, and implementation workflows.
What you can do:
- Create and scaffold projects, assets, schedules, and sensors
- Understand asset patterns (dependencies, partitions, multi-assets, metadata)
- Implement automation (declarative automation, schedules, sensors)
- Use CLI commands (launch, list, check, scaffold, logs)
- Design project structure and configure environments
- Follow implementation workflows and best practices
- Debug issues and validate project configuration
Example prompts:
Create a new Dagster project called analytics
How do I scaffold a new asset?
Show me how to set up declarative automation
What's the proper way to partition my assets?
Help me debug why my materialization failed
How should I structure my project for multiple pipelines?
Launch all assets tagged with priority=high
Dagster+ MCP
Direct access to Dagster+ data about your deployment, including run logs, Insights, and select actions to remediate failures.
The MCP server uses your user permissions when determining the MCP server permissions. To use custom permissions, see the documentation for alternative authentication methods here
What you can do:
- Launch runs, materialize assets, re-run runs and backfills
- Fetch run logs
- Fetch asset definitions and metadata
- Fetch deployments and deployment information.
- Create and update alert policies and fetch their notifications
- Fetch Insights metrics for assets, jobs, and deployments
Example prompts:
Fetch the logs for run <run id>, investigate why it failed, and propose a solution.
What is the materialization success rate over the past month?
How often has the customer_returns_job failed in the past quarter?
What assets in my deployment are not covered by an alert policy?
Contributing
See CONTRIBUTING.md.