
Setting Up Astro Project
Scaffolds new Airflow projects using Astro CLI and handles the dependency setup you'd otherwise need to figure out from docs. Creates the standard project structure (dags, plugins, tests folders), manages Python and OS packages through requirements.txt and packages.txt, and configures connections and variables via airflow_settings.yaml so they load automatically on startup. The smart bit is it defaults to latest Astro Runtime unless you explicitly pin a version, which saves you from accidentally locking to stale training data. Works hand in hand with the managing-astro-local-env skill for actually running things and authoring-dags for writing your pipelines. If you're not on Astro, it'll point you to the Apache Airflow Docker Compose setup instead.
- skills.sh installs
- 1.1K
- GitHub stars
- 459
- last updated
- Aug 21, 2026
Install
$ npx -y skills add astronomer/agents --skill setting-up-astro-project --agent claude-codeInstalls into .claude/skills of the current project.
Files
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-airflowskill.
Initialize a New Project
astro dev init
Don't pass
--airflow-versionor--runtime-versionunless the user explicitly asks for a specific pin. Plainastro dev initresolves 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 generatedDockerfileafterward instead of guessing.
Sponsors
Details
- Repository
- github.com/astronomer/agents
- Category
- Frontend Development
- First seen
- Apr 16, 2026
More from astronomer/agents
All 24- Tracing Upstream Lineage1.1K
- Profiling Tables1.1K
- Tracing Downstream Lineage1.1K
- Checking Freshness1K
- Annotating Task Lineage1K
- Cosmos Dbt Core990
- Airflow Hitl980
- Creating Openlineage Extractors960
- Cosmos Dbt Fusion925
- Warehouse Init841
- Deploying Airflow817
- Troubleshooting Astro Deployments655
- Airflow Plugins622
- Managing Astro Deployments595
- Blueprint584
- Init176
- Managing Astro Local Env1.6K
- Airflow1.5K
- Analyzing Data1.4K
- Authoring Dags1.3K
- Debugging Dags1.2K
- Testing Dags1.2K
- Migrating Airflow 2 To 31.1K