name: ai-workflows
description: "Mage AI-assisted pipeline generation, documentation, and model configuration."
metadata:
disco-role: operating
disable-model-invocation: true
license: Apache 2.0
AI Workflows
Use this route for Mage's AI-assisted code and documentation helpers.
Owns
- Pipeline generation from descriptions
- Block generation from descriptions
- Block and pipeline documentation generation
- Comment generation for existing code
- OpenAI and Hugging Face AI client configuration
- AI setup and credential troubleshooting
Excludes
- Manual block authoring, which belongs in
pipeline-authoring
- Connector or
io_config setup, which belongs in batch-integrations
- Streaming connectors, which belong in
streaming
- dbt orchestration, which belongs in
dbt-workflows
- CLI/bootstrap/auth/logging, which belongs in
platform-ops
Use this route when
- The user asks Mage to generate a pipeline or block from a prompt
- The user wants docs or comments generated for code already in the repo
- The user needs to configure or debug AI model access for Mage features
Bundled reference
Read references/ai-workflows.md for the AI command matrix, config objects, and setup notes.
Bundled script
scripts/check_ai_config.py — safe AI-mode and credential inspection without calling a live model
Core reminders
- The code supports both OpenAI and Hugging Face client paths.
- AI features require a valid API key or endpoint configuration.
- Mage Pro chat features exist in the repo, but the OSS generation helpers are the main workflow in this skill.