mcpField
S
setting-up-astro-project

setting-up-astro-project

github.com/necatiarslanData & databases4446 installsUpdated 21w ago
Repository

About setting-up-astro-project

A setup skill for Airflow projects built with Astro CLI. It covers project initialization, dependency and connection configuration, and DAG parsing before running the environment.

Key features

  1. 01Initialize project structure
  2. 02Configure Python and OS dependencies
  3. 03Set up connections and variables
  4. 04Export and import connection settings
  5. 05Parse DAGs before running

Use cases

  1. 01Start a new Astro Airflow project
  2. 02Add project dependencies
  3. 03Configure local Airflow connections
  4. 04Check DAG syntax before startup

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/necatiarslan/airflow-vscode-extension --skill setting-up-astro-project

After installing, type/setting-up-astro-projectin Claude Code to confirm it loaded.

Details

From the project README

Astro Project Setup

This skill helps initialize and configure Airflow projects using the Astro CLI.

Note: These are external CLI actions. For runtime inspection inside the VS Code extension, use the extension tools.

Initialize a New Project

astro dev init

Creates this structure:

project/
├── dags/                # DAG files
├── include/             # SQL, configs, supporting files
├── plugins/             # Custom Airflow plugins
├── tests/               # Unit tests
├── Dockerfile           # Image customization
├── packages.txt         # OS-level packages
├── requirements.txt     # Python packages
└── airflow_settings.yaml # Connections, variables, pools

Adding Dependencies

Python Packages (requirements.txt)
apache-airflow-providers-snowflake==5.3.0
pandas==2.1.0
requests>=2.28.0
OS Packages (packages.txt)
gcc
libpq-dev
Custom Dockerfile
FROM quay.io/astronomer/astro-runtime:12.4.0

RUN pip install --extra-index-url https://pypi.example.com/simple my-package

After modifying dependencies: run astro dev restart.

Configuring Connections and Variables

airflow_settings.yaml

Loaded automatically on environment start:

airflow:
  connections:
    - conn_id: my_postgres
      conn_type: postgres
      host: host.docker.internal
      port: 5432
      login: user
      password: pass
      schema: mydb

  variables:
    - variable_name: env
      variable_value: dev

  pools:
    - pool_name: limited_pool
      pool_slot: 5
Export/Import
# Export from running environment
astro dev object export --connections --file connections.yaml

# Import to environment
astro dev object import --connections --file connections.yaml

Validate Before Running

Parse DAGs to catch errors without starting the full environment:

astro dev parse

Related Skills

  • managing-astro-local-env
  • authoring-dags
  • testing-dags

Comments

Markdown supported