Initialize and configure Astro/Airflow projects. Use when the user wants to create a new project, set up dependencies, configure connections/variables, or understand project structure. For running the local environment, see managing-astro-local-env.

Astro Project Setup This skill helps you initialize and configure Airflow projects using the Astro CLI. To run the local environment , see the managing astro local env skill. To write DAGs , see the authoring dags skill. Open source alternative: If the user isn't on Astro, guide them to Apache Airflow's Docker Compose quickstart for local dev and the Helm chart for production. For deployment strategies, use the deploying airflow skill. Initialize a New Project Don't pass airflow version or runtime version unless the user explicitly asks for a specific pin. Plain astro dev init resolves to the latest Astro Runtime — that's the right default. Specifying a version risks pinning to a stale value from training data. If the user wants to know what was installed, read the generated Dockerfile afterward instead of guessing. Creates this structure: Adding Dependencies Python Packages (requirements.txt) OS Packages (packages.txt) Custom Dockerfile For complex setups (private PyPI, custom scripts): After modifying dependencies: Run astro dev restart Configuring Connections & Variables airflow settings.yaml Loaded automatically on environment start: Export/Import Validate Before Running Parse DAGs to catch errors without starting the full environment: Related Skills managing astro local env : Start, stop, and troubleshoot the local environment authoring dags : Write and validate DAGs (uses MCP tools) testing dags : Test DAGs (uses MCP tools) deploying airflow : Deploy DAGs to production (Astro, Docker Compose, Kubernetes)

setting-up-astro-project