[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-astronomer-setting-up-astro-project":3,"mdc--ucmlqq-key":52,"related-repo-astronomer-setting-up-astro-project":838,"related-org-astronomer-setting-up-astro-project":938},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":22,"repoUrl":23,"updatedAt":24,"license":25,"forks":26,"topics":27,"repo":47,"sourceUrl":50,"mdContent":51},"setting-up-astro-project","initialize Astro Airflow projects","Initialize and configure Astro\u002FAirflow projects. Use when the user wants to create a new project, set up dependencies, configure connections\u002Fvariables, or understand project structure. For running the local environment, see managing-astro-local-env.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"astronomer","Astronomer","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fastronomer.png",[12,16,19],{"name":13,"slug":14,"type":15},"Airflow","airflow","tag",{"name":17,"slug":18,"type":15},"Data Pipeline","data-pipeline",{"name":20,"slug":21,"type":15},"Python","python",412,"https:\u002F\u002Fgithub.com\u002Fastronomer\u002Fagents","2026-04-06T18:02:07.565931",null,55,[28,29,30,31,14,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46],"agentic-workflow","agents","ai","ai-agents","apache-airflow","claude","cursor","dag","data-engineering","data-pipelines","dbt","llm","mcp","orchestrator","skills","workflow-automation","workflow-management","workflow-orchestration","workflows",{"repoUrl":23,"stars":22,"forks":26,"topics":48,"description":49},[28,29,30,31,14,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46],"AI agent tooling for data engineering workflows.","https:\u002F\u002Fgithub.com\u002Fastronomer\u002Fagents\u002Ftree\u002FHEAD\u002Fskills\u002Fsetting-up-astro-project","---\nname: setting-up-astro-project\ndescription: Initialize and configure Astro\u002FAirflow projects. Use when the user wants to create a new project, set up dependencies, configure connections\u002Fvariables, or understand project structure. For running the local environment, see managing-astro-local-env.\n---\n\n# Astro Project Setup\n\nThis skill helps you initialize and configure Airflow projects using the Astro CLI.\n\n> **To run the local environment**, see the **managing-astro-local-env** skill.\n> **To write DAGs**, see the **authoring-dags** skill.\n> **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.\n\n---\n\n## Initialize a New Project\n\n```bash\nastro dev init\n```\n\n> **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.\n\nCreates this structure:\n```\nproject\u002F\n├── dags\u002F                # DAG files\n├── include\u002F             # SQL, configs, supporting files\n├── plugins\u002F             # Custom Airflow plugins\n├── tests\u002F               # Unit tests\n├── Dockerfile           # Image customization\n├── packages.txt         # OS-level packages\n├── requirements.txt     # Python packages\n└── airflow_settings.yaml # Connections, variables, pools\n```\n\n---\n\n## Adding Dependencies\n\n### Python Packages (requirements.txt)\n\n```\napache-airflow-providers-snowflake==5.3.0\npandas==2.1.0\nrequests>=2.28.0\n```\n\n### OS Packages (packages.txt)\n\n```\ngcc\nlibpq-dev\n```\n\n### Custom Dockerfile\n\nFor complex setups (private PyPI, custom scripts):\n\n```dockerfile\nFROM quay.io\u002Fastronomer\u002Fastro-runtime:12.4.0\n\nRUN pip install --extra-index-url https:\u002F\u002Fpypi.example.com\u002Fsimple my-package\n```\n\n**After modifying dependencies:** Run `astro dev restart`\n\n---\n\n## Configuring Connections & Variables\n\n### airflow_settings.yaml\n\nLoaded automatically on environment start:\n\n```yaml\nairflow:\n  connections:\n    - conn_id: my_postgres\n      conn_type: postgres\n      host: host.docker.internal\n      port: 5432\n      login: user\n      password: pass\n      schema: mydb\n\n  variables:\n    - variable_name: env\n      variable_value: dev\n\n  pools:\n    - pool_name: limited_pool\n      pool_slot: 5\n```\n\n### Export\u002FImport\n\n```bash\n# Export from running environment\nastro dev object export --connections --file connections.yaml\n\n# Import to environment\nastro dev object import --connections --file connections.yaml\n```\n\n---\n\n## Validate Before Running\n\nParse DAGs to catch errors without starting the full environment:\n\n```bash\nastro dev parse\n```\n\n---\n\n## Related Skills\n\n- **managing-astro-local-env**: Start, stop, and troubleshoot the local environment\n- **authoring-dags**: Write and validate DAGs (uses MCP tools)\n- **testing-dags**: Test DAGs (uses MCP tools)\n- **deploying-airflow**: Deploy DAGs to production (Astro, Docker Compose, Kubernetes)\n",{"data":53,"body":54},{"name":4,"description":6},{"type":55,"children":56},"root",[57,66,72,122,126,133,167,212,217,227,230,236,243,252,258,267,273,278,314,330,333,339,345,350,639,645,744,747,753,758,781,784,790,832],{"type":58,"tag":59,"props":60,"children":62},"element","h1",{"id":61},"astro-project-setup",[63],{"type":64,"value":65},"text","Astro Project Setup",{"type":58,"tag":67,"props":68,"children":69},"p",{},[70],{"type":64,"value":71},"This skill helps you initialize and configure Airflow projects using the Astro CLI.",{"type":58,"tag":73,"props":74,"children":75},"blockquote",{},[76],{"type":58,"tag":67,"props":77,"children":78},{},[79,85,87,92,94,99,100,105,106,111,113,120],{"type":58,"tag":80,"props":81,"children":82},"strong",{},[83],{"type":64,"value":84},"To run the local environment",{"type":64,"value":86},", see the ",{"type":58,"tag":80,"props":88,"children":89},{},[90],{"type":64,"value":91},"managing-astro-local-env",{"type":64,"value":93}," skill.\n",{"type":58,"tag":80,"props":95,"children":96},{},[97],{"type":64,"value":98},"To write DAGs",{"type":64,"value":86},{"type":58,"tag":80,"props":101,"children":102},{},[103],{"type":64,"value":104},"authoring-dags",{"type":64,"value":93},{"type":58,"tag":80,"props":107,"children":108},{},[109],{"type":64,"value":110},"Open-source alternative:",{"type":64,"value":112}," 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 ",{"type":58,"tag":114,"props":115,"children":117},"code",{"className":116},[],[118],{"type":64,"value":119},"deploying-airflow",{"type":64,"value":121}," skill.",{"type":58,"tag":123,"props":124,"children":125},"hr",{},[],{"type":58,"tag":127,"props":128,"children":130},"h2",{"id":129},"initialize-a-new-project",[131],{"type":64,"value":132},"Initialize a New Project",{"type":58,"tag":134,"props":135,"children":140},"pre",{"className":136,"code":137,"language":138,"meta":139,"style":139},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","astro dev init\n","bash","",[141],{"type":58,"tag":114,"props":142,"children":143},{"__ignoreMap":139},[144],{"type":58,"tag":145,"props":146,"children":149},"span",{"class":147,"line":148},"line",1,[150,156,162],{"type":58,"tag":145,"props":151,"children":153},{"style":152},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[154],{"type":64,"value":155},"astro",{"type":58,"tag":145,"props":157,"children":159},{"style":158},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[160],{"type":64,"value":161}," dev",{"type":58,"tag":145,"props":163,"children":164},{"style":158},[165],{"type":64,"value":166}," init\n",{"type":58,"tag":73,"props":168,"children":169},{},[170],{"type":58,"tag":67,"props":171,"children":172},{},[173,194,196,202,204,210],{"type":58,"tag":80,"props":174,"children":175},{},[176,178,184,186,192],{"type":64,"value":177},"Don't pass ",{"type":58,"tag":114,"props":179,"children":181},{"className":180},[],[182],{"type":64,"value":183},"--airflow-version",{"type":64,"value":185}," or ",{"type":58,"tag":114,"props":187,"children":189},{"className":188},[],[190],{"type":64,"value":191},"--runtime-version",{"type":64,"value":193}," unless the user explicitly asks for a specific pin.",{"type":64,"value":195}," Plain ",{"type":58,"tag":114,"props":197,"children":199},{"className":198},[],[200],{"type":64,"value":201},"astro dev init",{"type":64,"value":203}," 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 ",{"type":58,"tag":114,"props":205,"children":207},{"className":206},[],[208],{"type":64,"value":209},"Dockerfile",{"type":64,"value":211}," afterward instead of guessing.",{"type":58,"tag":67,"props":213,"children":214},{},[215],{"type":64,"value":216},"Creates this structure:",{"type":58,"tag":134,"props":218,"children":222},{"className":219,"code":221,"language":64},[220],"language-text","project\u002F\n├── dags\u002F                # DAG files\n├── include\u002F             # SQL, configs, supporting files\n├── plugins\u002F             # Custom Airflow plugins\n├── tests\u002F               # Unit tests\n├── Dockerfile           # Image customization\n├── packages.txt         # OS-level packages\n├── requirements.txt     # Python packages\n└── airflow_settings.yaml # Connections, variables, pools\n",[223],{"type":58,"tag":114,"props":224,"children":225},{"__ignoreMap":139},[226],{"type":64,"value":221},{"type":58,"tag":123,"props":228,"children":229},{},[],{"type":58,"tag":127,"props":231,"children":233},{"id":232},"adding-dependencies",[234],{"type":64,"value":235},"Adding Dependencies",{"type":58,"tag":237,"props":238,"children":240},"h3",{"id":239},"python-packages-requirementstxt",[241],{"type":64,"value":242},"Python Packages (requirements.txt)",{"type":58,"tag":134,"props":244,"children":247},{"className":245,"code":246,"language":64},[220],"apache-airflow-providers-snowflake==5.3.0\npandas==2.1.0\nrequests>=2.28.0\n",[248],{"type":58,"tag":114,"props":249,"children":250},{"__ignoreMap":139},[251],{"type":64,"value":246},{"type":58,"tag":237,"props":253,"children":255},{"id":254},"os-packages-packagestxt",[256],{"type":64,"value":257},"OS Packages (packages.txt)",{"type":58,"tag":134,"props":259,"children":262},{"className":260,"code":261,"language":64},[220],"gcc\nlibpq-dev\n",[263],{"type":58,"tag":114,"props":264,"children":265},{"__ignoreMap":139},[266],{"type":64,"value":261},{"type":58,"tag":237,"props":268,"children":270},{"id":269},"custom-dockerfile",[271],{"type":64,"value":272},"Custom Dockerfile",{"type":58,"tag":67,"props":274,"children":275},{},[276],{"type":64,"value":277},"For complex setups (private PyPI, custom scripts):",{"type":58,"tag":134,"props":279,"children":283},{"className":280,"code":281,"language":282,"meta":139,"style":139},"language-dockerfile shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","FROM quay.io\u002Fastronomer\u002Fastro-runtime:12.4.0\n\nRUN pip install --extra-index-url https:\u002F\u002Fpypi.example.com\u002Fsimple my-package\n","dockerfile",[284],{"type":58,"tag":114,"props":285,"children":286},{"__ignoreMap":139},[287,295,305],{"type":58,"tag":145,"props":288,"children":289},{"class":147,"line":148},[290],{"type":58,"tag":145,"props":291,"children":292},{},[293],{"type":64,"value":294},"FROM quay.io\u002Fastronomer\u002Fastro-runtime:12.4.0\n",{"type":58,"tag":145,"props":296,"children":298},{"class":147,"line":297},2,[299],{"type":58,"tag":145,"props":300,"children":302},{"emptyLinePlaceholder":301},true,[303],{"type":64,"value":304},"\n",{"type":58,"tag":145,"props":306,"children":308},{"class":147,"line":307},3,[309],{"type":58,"tag":145,"props":310,"children":311},{},[312],{"type":64,"value":313},"RUN pip install --extra-index-url https:\u002F\u002Fpypi.example.com\u002Fsimple my-package\n",{"type":58,"tag":67,"props":315,"children":316},{},[317,322,324],{"type":58,"tag":80,"props":318,"children":319},{},[320],{"type":64,"value":321},"After modifying dependencies:",{"type":64,"value":323}," Run ",{"type":58,"tag":114,"props":325,"children":327},{"className":326},[],[328],{"type":64,"value":329},"astro dev restart",{"type":58,"tag":123,"props":331,"children":332},{},[],{"type":58,"tag":127,"props":334,"children":336},{"id":335},"configuring-connections-variables",[337],{"type":64,"value":338},"Configuring Connections & Variables",{"type":58,"tag":237,"props":340,"children":342},{"id":341},"airflow_settingsyaml",[343],{"type":64,"value":344},"airflow_settings.yaml",{"type":58,"tag":67,"props":346,"children":347},{},[348],{"type":64,"value":349},"Loaded automatically on environment start:",{"type":58,"tag":134,"props":351,"children":355},{"className":352,"code":353,"language":354,"meta":139,"style":139},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","airflow:\n  connections:\n    - conn_id: my_postgres\n      conn_type: postgres\n      host: host.docker.internal\n      port: 5432\n      login: user\n      password: pass\n      schema: mydb\n\n  variables:\n    - variable_name: env\n      variable_value: dev\n\n  pools:\n    - pool_name: limited_pool\n      pool_slot: 5\n","yaml",[356],{"type":58,"tag":114,"props":357,"children":358},{"__ignoreMap":139},[359,373,385,408,426,444,463,481,499,517,525,538,560,578,586,599,621],{"type":58,"tag":145,"props":360,"children":361},{"class":147,"line":148},[362,367],{"type":58,"tag":145,"props":363,"children":365},{"style":364},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[366],{"type":64,"value":14},{"type":58,"tag":145,"props":368,"children":370},{"style":369},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[371],{"type":64,"value":372},":\n",{"type":58,"tag":145,"props":374,"children":375},{"class":147,"line":297},[376,381],{"type":58,"tag":145,"props":377,"children":378},{"style":364},[379],{"type":64,"value":380},"  connections",{"type":58,"tag":145,"props":382,"children":383},{"style":369},[384],{"type":64,"value":372},{"type":58,"tag":145,"props":386,"children":387},{"class":147,"line":307},[388,393,398,403],{"type":58,"tag":145,"props":389,"children":390},{"style":369},[391],{"type":64,"value":392},"    -",{"type":58,"tag":145,"props":394,"children":395},{"style":364},[396],{"type":64,"value":397}," conn_id",{"type":58,"tag":145,"props":399,"children":400},{"style":369},[401],{"type":64,"value":402},":",{"type":58,"tag":145,"props":404,"children":405},{"style":158},[406],{"type":64,"value":407}," my_postgres\n",{"type":58,"tag":145,"props":409,"children":411},{"class":147,"line":410},4,[412,417,421],{"type":58,"tag":145,"props":413,"children":414},{"style":364},[415],{"type":64,"value":416},"      conn_type",{"type":58,"tag":145,"props":418,"children":419},{"style":369},[420],{"type":64,"value":402},{"type":58,"tag":145,"props":422,"children":423},{"style":158},[424],{"type":64,"value":425}," postgres\n",{"type":58,"tag":145,"props":427,"children":429},{"class":147,"line":428},5,[430,435,439],{"type":58,"tag":145,"props":431,"children":432},{"style":364},[433],{"type":64,"value":434},"      host",{"type":58,"tag":145,"props":436,"children":437},{"style":369},[438],{"type":64,"value":402},{"type":58,"tag":145,"props":440,"children":441},{"style":158},[442],{"type":64,"value":443}," host.docker.internal\n",{"type":58,"tag":145,"props":445,"children":447},{"class":147,"line":446},6,[448,453,457],{"type":58,"tag":145,"props":449,"children":450},{"style":364},[451],{"type":64,"value":452},"      port",{"type":58,"tag":145,"props":454,"children":455},{"style":369},[456],{"type":64,"value":402},{"type":58,"tag":145,"props":458,"children":460},{"style":459},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[461],{"type":64,"value":462}," 5432\n",{"type":58,"tag":145,"props":464,"children":466},{"class":147,"line":465},7,[467,472,476],{"type":58,"tag":145,"props":468,"children":469},{"style":364},[470],{"type":64,"value":471},"      login",{"type":58,"tag":145,"props":473,"children":474},{"style":369},[475],{"type":64,"value":402},{"type":58,"tag":145,"props":477,"children":478},{"style":158},[479],{"type":64,"value":480}," user\n",{"type":58,"tag":145,"props":482,"children":484},{"class":147,"line":483},8,[485,490,494],{"type":58,"tag":145,"props":486,"children":487},{"style":364},[488],{"type":64,"value":489},"      password",{"type":58,"tag":145,"props":491,"children":492},{"style":369},[493],{"type":64,"value":402},{"type":58,"tag":145,"props":495,"children":496},{"style":158},[497],{"type":64,"value":498}," pass\n",{"type":58,"tag":145,"props":500,"children":502},{"class":147,"line":501},9,[503,508,512],{"type":58,"tag":145,"props":504,"children":505},{"style":364},[506],{"type":64,"value":507},"      schema",{"type":58,"tag":145,"props":509,"children":510},{"style":369},[511],{"type":64,"value":402},{"type":58,"tag":145,"props":513,"children":514},{"style":158},[515],{"type":64,"value":516}," mydb\n",{"type":58,"tag":145,"props":518,"children":520},{"class":147,"line":519},10,[521],{"type":58,"tag":145,"props":522,"children":523},{"emptyLinePlaceholder":301},[524],{"type":64,"value":304},{"type":58,"tag":145,"props":526,"children":528},{"class":147,"line":527},11,[529,534],{"type":58,"tag":145,"props":530,"children":531},{"style":364},[532],{"type":64,"value":533},"  variables",{"type":58,"tag":145,"props":535,"children":536},{"style":369},[537],{"type":64,"value":372},{"type":58,"tag":145,"props":539,"children":541},{"class":147,"line":540},12,[542,546,551,555],{"type":58,"tag":145,"props":543,"children":544},{"style":369},[545],{"type":64,"value":392},{"type":58,"tag":145,"props":547,"children":548},{"style":364},[549],{"type":64,"value":550}," variable_name",{"type":58,"tag":145,"props":552,"children":553},{"style":369},[554],{"type":64,"value":402},{"type":58,"tag":145,"props":556,"children":557},{"style":158},[558],{"type":64,"value":559}," env\n",{"type":58,"tag":145,"props":561,"children":563},{"class":147,"line":562},13,[564,569,573],{"type":58,"tag":145,"props":565,"children":566},{"style":364},[567],{"type":64,"value":568},"      variable_value",{"type":58,"tag":145,"props":570,"children":571},{"style":369},[572],{"type":64,"value":402},{"type":58,"tag":145,"props":574,"children":575},{"style":158},[576],{"type":64,"value":577}," dev\n",{"type":58,"tag":145,"props":579,"children":581},{"class":147,"line":580},14,[582],{"type":58,"tag":145,"props":583,"children":584},{"emptyLinePlaceholder":301},[585],{"type":64,"value":304},{"type":58,"tag":145,"props":587,"children":589},{"class":147,"line":588},15,[590,595],{"type":58,"tag":145,"props":591,"children":592},{"style":364},[593],{"type":64,"value":594},"  pools",{"type":58,"tag":145,"props":596,"children":597},{"style":369},[598],{"type":64,"value":372},{"type":58,"tag":145,"props":600,"children":602},{"class":147,"line":601},16,[603,607,612,616],{"type":58,"tag":145,"props":604,"children":605},{"style":369},[606],{"type":64,"value":392},{"type":58,"tag":145,"props":608,"children":609},{"style":364},[610],{"type":64,"value":611}," pool_name",{"type":58,"tag":145,"props":613,"children":614},{"style":369},[615],{"type":64,"value":402},{"type":58,"tag":145,"props":617,"children":618},{"style":158},[619],{"type":64,"value":620}," limited_pool\n",{"type":58,"tag":145,"props":622,"children":624},{"class":147,"line":623},17,[625,630,634],{"type":58,"tag":145,"props":626,"children":627},{"style":364},[628],{"type":64,"value":629},"      pool_slot",{"type":58,"tag":145,"props":631,"children":632},{"style":369},[633],{"type":64,"value":402},{"type":58,"tag":145,"props":635,"children":636},{"style":459},[637],{"type":64,"value":638}," 5\n",{"type":58,"tag":237,"props":640,"children":642},{"id":641},"exportimport",[643],{"type":64,"value":644},"Export\u002FImport",{"type":58,"tag":134,"props":646,"children":648},{"className":136,"code":647,"language":138,"meta":139,"style":139},"# Export from running environment\nastro dev object export --connections --file connections.yaml\n\n# Import to environment\nastro dev object import --connections --file connections.yaml\n",[649],{"type":58,"tag":114,"props":650,"children":651},{"__ignoreMap":139},[652,661,697,704,712],{"type":58,"tag":145,"props":653,"children":654},{"class":147,"line":148},[655],{"type":58,"tag":145,"props":656,"children":658},{"style":657},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[659],{"type":64,"value":660},"# Export from running environment\n",{"type":58,"tag":145,"props":662,"children":663},{"class":147,"line":297},[664,668,672,677,682,687,692],{"type":58,"tag":145,"props":665,"children":666},{"style":152},[667],{"type":64,"value":155},{"type":58,"tag":145,"props":669,"children":670},{"style":158},[671],{"type":64,"value":161},{"type":58,"tag":145,"props":673,"children":674},{"style":158},[675],{"type":64,"value":676}," object",{"type":58,"tag":145,"props":678,"children":679},{"style":158},[680],{"type":64,"value":681}," export",{"type":58,"tag":145,"props":683,"children":684},{"style":158},[685],{"type":64,"value":686}," --connections",{"type":58,"tag":145,"props":688,"children":689},{"style":158},[690],{"type":64,"value":691}," --file",{"type":58,"tag":145,"props":693,"children":694},{"style":158},[695],{"type":64,"value":696}," connections.yaml\n",{"type":58,"tag":145,"props":698,"children":699},{"class":147,"line":307},[700],{"type":58,"tag":145,"props":701,"children":702},{"emptyLinePlaceholder":301},[703],{"type":64,"value":304},{"type":58,"tag":145,"props":705,"children":706},{"class":147,"line":410},[707],{"type":58,"tag":145,"props":708,"children":709},{"style":657},[710],{"type":64,"value":711},"# Import to environment\n",{"type":58,"tag":145,"props":713,"children":714},{"class":147,"line":428},[715,719,723,727,732,736,740],{"type":58,"tag":145,"props":716,"children":717},{"style":152},[718],{"type":64,"value":155},{"type":58,"tag":145,"props":720,"children":721},{"style":158},[722],{"type":64,"value":161},{"type":58,"tag":145,"props":724,"children":725},{"style":158},[726],{"type":64,"value":676},{"type":58,"tag":145,"props":728,"children":729},{"style":158},[730],{"type":64,"value":731}," import",{"type":58,"tag":145,"props":733,"children":734},{"style":158},[735],{"type":64,"value":686},{"type":58,"tag":145,"props":737,"children":738},{"style":158},[739],{"type":64,"value":691},{"type":58,"tag":145,"props":741,"children":742},{"style":158},[743],{"type":64,"value":696},{"type":58,"tag":123,"props":745,"children":746},{},[],{"type":58,"tag":127,"props":748,"children":750},{"id":749},"validate-before-running",[751],{"type":64,"value":752},"Validate Before Running",{"type":58,"tag":67,"props":754,"children":755},{},[756],{"type":64,"value":757},"Parse DAGs to catch errors without starting the full environment:",{"type":58,"tag":134,"props":759,"children":761},{"className":136,"code":760,"language":138,"meta":139,"style":139},"astro dev parse\n",[762],{"type":58,"tag":114,"props":763,"children":764},{"__ignoreMap":139},[765],{"type":58,"tag":145,"props":766,"children":767},{"class":147,"line":148},[768,772,776],{"type":58,"tag":145,"props":769,"children":770},{"style":152},[771],{"type":64,"value":155},{"type":58,"tag":145,"props":773,"children":774},{"style":158},[775],{"type":64,"value":161},{"type":58,"tag":145,"props":777,"children":778},{"style":158},[779],{"type":64,"value":780}," parse\n",{"type":58,"tag":123,"props":782,"children":783},{},[],{"type":58,"tag":127,"props":785,"children":787},{"id":786},"related-skills",[788],{"type":64,"value":789},"Related Skills",{"type":58,"tag":791,"props":792,"children":793},"ul",{},[794,804,813,823],{"type":58,"tag":795,"props":796,"children":797},"li",{},[798,802],{"type":58,"tag":80,"props":799,"children":800},{},[801],{"type":64,"value":91},{"type":64,"value":803},": Start, stop, and troubleshoot the local environment",{"type":58,"tag":795,"props":805,"children":806},{},[807,811],{"type":58,"tag":80,"props":808,"children":809},{},[810],{"type":64,"value":104},{"type":64,"value":812},": Write and validate DAGs (uses MCP tools)",{"type":58,"tag":795,"props":814,"children":815},{},[816,821],{"type":58,"tag":80,"props":817,"children":818},{},[819],{"type":64,"value":820},"testing-dags",{"type":64,"value":822},": Test DAGs (uses MCP tools)",{"type":58,"tag":795,"props":824,"children":825},{},[826,830],{"type":58,"tag":80,"props":827,"children":828},{},[829],{"type":64,"value":119},{"type":64,"value":831},": Deploy DAGs to production (Astro, Docker Compose, Kubernetes)",{"type":58,"tag":833,"props":834,"children":835},"style",{},[836],{"type":64,"value":837},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":839,"total":937},[840,854,866,881,895,912,925],{"slug":14,"name":14,"fn":841,"description":842,"org":843,"tags":844,"stars":22,"repoUrl":23,"updatedAt":853},"manage and troubleshoot Airflow via CLI","Queries, manages, and troubleshoots Apache Airflow using the `af` CLI. Use when working with anything related to Airflow - a DAG, a DAG run, a task log, an import or parse error, a broken DAG, or any Airflow operation. Covers listing and triggering DAGs, retrying runs, reading task logs, diagnosing failures, debugging import and parse errors, checking connections, variables and pools, exploring the REST API, and monitoring health (for example \"trigger a pipeline\", \"retry a run\", \"list connections\", \"check Airflow health\", \"why did my DAG fail\"). This is the entrypoint that routes to sibling skills for authoring, testing, deploying, and migrating Airflow 2 to 3. Not for warehouse\u002FSQL analytics on Airflow metadata tables (use analyzing-data); for deep root-cause reports use debugging-dags or airflow-investigation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[845,846,849,850],{"name":13,"slug":14,"type":15},{"name":847,"slug":848,"type":15},"CLI","cli",{"name":17,"slug":18,"type":15},{"name":851,"slug":852,"type":15},"Debugging","debugging","2026-04-06T18:01:43.992997",{"slug":855,"name":855,"fn":856,"description":857,"org":858,"tags":859,"stars":22,"repoUrl":23,"updatedAt":865},"airflow-hitl","add human-in-the-loop steps to Airflow DAGs","Builds human-in-the-loop (HITL) Airflow workflows - approval gates, form input, and human-driven branching. Use when a DAG needs a human in the loop - an approval or reject step, sign-off before a task runs, a decision or approval UI, branching on a human choice, or collecting form input mid-run; also on mentions of ApprovalOperator, HITLOperator, HITLBranchOperator, HITLEntryOperator, or HITLTrigger. Requires Airflow 3.1+. Not for AI\u002FLLM task calls (see migrating-ai-sdk-to-common-ai).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[860,861,864],{"name":13,"slug":14,"type":15},{"name":862,"slug":863,"type":15},"Approvals","approvals",{"name":17,"slug":18,"type":15},"2026-04-06T18:01:46.758548",{"slug":867,"name":867,"fn":868,"description":869,"org":870,"tags":871,"stars":22,"repoUrl":23,"updatedAt":880},"airflow-plugins","build Airflow UI plugins","Builds Airflow 3.1+ plugins that embed FastAPI apps, custom UI pages, React components, middleware, macros, and operator links directly into the Airflow UI. Use when building anything custom inside Airflow 3.1+ that involves Python and a browser-facing interface - creating an Airflow plugin, adding a custom UI page or nav entry, building FastAPI-backed endpoints inside Airflow, serving static assets from a plugin, embedding a React app, adding middleware to the API server, creating custom operator extra links, or calling the Airflow REST API from inside a plugin; also when AirflowPlugin, fastapi_apps, external_views, react_apps, or plugin registration come up.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[872,873,876,877],{"name":13,"slug":14,"type":15},{"name":874,"slug":875,"type":15},"Plugin Development","plugin-development",{"name":20,"slug":21,"type":15},{"name":878,"slug":879,"type":15},"UI Components","ui-components","2026-04-06T18:01:56.827891",{"slug":882,"name":882,"fn":883,"description":884,"org":885,"tags":886,"stars":22,"repoUrl":23,"updatedAt":894},"airflow-state-store","persist Airflow task and asset state","Persists task and asset state across retries and DAG runs using Airflow 3.3's AIP-103 key\u002Fvalue stores (`task_state_store`, `asset_state_store`) and the crash-safe `ResumableJobMixin`. Use when the user asks about task state store, checkpointing in tasks, persisting state across retries, job IDs surviving worker crashes, watermarks, asset metadata, resumable tasks, crash-safe operators, or \"what's new in Airflow 3.3\". Also use proactively when reading a DAG that uses Variables or XCom for intra-task coordination state — flag the anti-pattern and recommend task_state_store or asset_state_store instead. Requires Airflow 3.3+.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[887,888,890,891],{"name":13,"slug":14,"type":15},{"name":889,"slug":36,"type":15},"Data Engineering",{"name":17,"slug":18,"type":15},{"name":892,"slug":893,"type":15},"Operations","operations","2026-07-07T06:43:11.160671",{"slug":896,"name":896,"fn":897,"description":898,"org":899,"tags":900,"stars":22,"repoUrl":23,"updatedAt":911},"analyzing-data","query data warehouses for business questions","Queries the data warehouse with SQL and answers business questions about data. Use when answering anything that needs warehouse data - counts, metrics, trends, aggregations, joins across tables, data lookups, or ad-hoc SQL analysis (for example \"who uses X\", \"how many Y\", \"show me Z\", \"find customers\", \"what is the count\").",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[901,904,907,908],{"name":902,"slug":903,"type":15},"Analytics","analytics",{"name":905,"slug":906,"type":15},"Data Analysis","data-analysis",{"name":889,"slug":36,"type":15},{"name":909,"slug":910,"type":15},"SQL","sql","2026-04-06T18:01:49.599775",{"slug":913,"name":913,"fn":914,"description":915,"org":916,"tags":917,"stars":22,"repoUrl":23,"updatedAt":924},"annotating-task-lineage","annotate Airflow tasks with data lineage","Annotate Airflow tasks with data lineage using inlets and outlets. Use when the user wants to add lineage metadata to tasks, specify input\u002Foutput datasets, or enable lineage tracking for operators without built-in OpenLineage extraction.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[918,919,920,921],{"name":13,"slug":14,"type":15},{"name":889,"slug":36,"type":15},{"name":17,"slug":18,"type":15},{"name":922,"slug":923,"type":15},"Observability","observability","2026-04-06T18:02:03.487365",{"slug":104,"name":104,"fn":926,"description":927,"org":928,"tags":929,"stars":22,"repoUrl":23,"updatedAt":936},"author Airflow DAGs","Workflow and best practices for writing Apache Airflow DAGs. Use when creating a new DAG, write pipeline code, handling questions about DAG patterns and conventions or extending an existing DAG with a follow-up\u002Fdownstream task. ANY request shaped like 'add a DAG named X', 'write a pipeline', 'add a task that runs after Y', or 'extend the DAG'. For testing and debugging DAGs, see the testing-dags skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[930,931,932,935],{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"name":933,"slug":934,"type":15},"ETL","etl",{"name":20,"slug":21,"type":15},"2026-04-06T18:01:52.679888",34,{"items":939,"total":937},[940,947,953,960,967,974,981,988,1003,1017,1027,1040],{"slug":14,"name":14,"fn":841,"description":842,"org":941,"tags":942,"stars":22,"repoUrl":23,"updatedAt":853},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[943,944,945,946],{"name":13,"slug":14,"type":15},{"name":847,"slug":848,"type":15},{"name":17,"slug":18,"type":15},{"name":851,"slug":852,"type":15},{"slug":855,"name":855,"fn":856,"description":857,"org":948,"tags":949,"stars":22,"repoUrl":23,"updatedAt":865},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[950,951,952],{"name":13,"slug":14,"type":15},{"name":862,"slug":863,"type":15},{"name":17,"slug":18,"type":15},{"slug":867,"name":867,"fn":868,"description":869,"org":954,"tags":955,"stars":22,"repoUrl":23,"updatedAt":880},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[956,957,958,959],{"name":13,"slug":14,"type":15},{"name":874,"slug":875,"type":15},{"name":20,"slug":21,"type":15},{"name":878,"slug":879,"type":15},{"slug":882,"name":882,"fn":883,"description":884,"org":961,"tags":962,"stars":22,"repoUrl":23,"updatedAt":894},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[963,964,965,966],{"name":13,"slug":14,"type":15},{"name":889,"slug":36,"type":15},{"name":17,"slug":18,"type":15},{"name":892,"slug":893,"type":15},{"slug":896,"name":896,"fn":897,"description":898,"org":968,"tags":969,"stars":22,"repoUrl":23,"updatedAt":911},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[970,971,972,973],{"name":902,"slug":903,"type":15},{"name":905,"slug":906,"type":15},{"name":889,"slug":36,"type":15},{"name":909,"slug":910,"type":15},{"slug":913,"name":913,"fn":914,"description":915,"org":975,"tags":976,"stars":22,"repoUrl":23,"updatedAt":924},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[977,978,979,980],{"name":13,"slug":14,"type":15},{"name":889,"slug":36,"type":15},{"name":17,"slug":18,"type":15},{"name":922,"slug":923,"type":15},{"slug":104,"name":104,"fn":926,"description":927,"org":982,"tags":983,"stars":22,"repoUrl":23,"updatedAt":936},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[984,985,986,987],{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"name":933,"slug":934,"type":15},{"name":20,"slug":21,"type":15},{"slug":989,"name":989,"fn":990,"description":991,"org":992,"tags":993,"stars":22,"repoUrl":23,"updatedAt":1002},"authoring-go-sdk-tasks","implement Airflow tasks in Go","Writes Airflow task logic in Go using the Airflow Go SDK. Use when the user wants to implement Airflow tasks in Go, asks about `BundleProvider`\u002F`RegisterDags`, the `bundlev1` Registry\u002FDag interfaces, registering Go tasks (`AddTask`\u002F`AddTaskWithName`), dependency injection by parameter type (`context.Context`, `sdk.TIRunContext`, `*slog.Logger`, `sdk.Client`), or reading connections\u002Fvariables\u002FXComs from Go. This skill covers the Go-specific native API; the shared Python-stub pattern and conceptual model live in authoring-language-sdk-tasks. For building\u002Fpacking\u002Fshipping the bundle see deploying-go-sdk-bundles; for coordinator config see configuring-airflow-language-sdks.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[994,995,998,999],{"name":13,"slug":14,"type":15},{"name":996,"slug":997,"type":15},"API Development","api-development",{"name":17,"slug":18,"type":15},{"name":1000,"slug":1001,"type":15},"Go","go","2026-07-11T05:39:13.552213",{"slug":1004,"name":1004,"fn":1005,"description":1006,"org":1007,"tags":1008,"stars":22,"repoUrl":23,"updatedAt":1016},"authoring-java-sdk-tasks","implement Airflow tasks in Java","Writes Airflow task logic in Java, Kotlin, or any JVM language using the Airflow Java SDK. Use when the user wants to implement Airflow tasks in Java\u002FJVM, asks about `@Builder.Dag`\u002F`@Builder.Task`\u002F`@Builder.XCom`, the `Task`\u002F`BundleBuilder` interfaces, reading connections\u002Fvariables\u002FXComs from Java, the JSON-to-Java type mapping, or logging from Java tasks. This skill covers the Java-specific native API; the shared Python-stub pattern and conceptual model live in authoring-language-sdk-tasks. For building\u002Fshipping the bundle see deploying-java-sdk-bundles; for coordinator config see configuring-airflow-language-sdks.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1009,1010,1013],{"name":17,"slug":18,"type":15},{"name":1011,"slug":1012,"type":15},"Engineering","engineering",{"name":1014,"slug":1015,"type":15},"Java","java","2026-07-18T05:48:13.374003",{"slug":1018,"name":1018,"fn":1019,"description":1020,"org":1021,"tags":1022,"stars":22,"repoUrl":23,"updatedAt":1026},"authoring-language-sdk-tasks","implement non-Python Airflow tasks","The language-neutral foundation for Airflow language SDKs — implement task logic in a non-Python language while the DAG stays in Python. Use when the user wants to run an Airflow task in another language (Java, Kotlin, Go, or other JVM\u002Fnative languages), asks how the Python `@task.stub` pairs with native task code, how task\u002FDAG IDs must match across the two sides, how data passes via XCom as JSON, or which language SDKs exist. This skill owns the shared Python-stub pattern and conceptual model; for a specific language's native API, build, and runtime, use that language's skill (e.g. authoring-java-sdk-tasks, authoring-go-sdk-tasks).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1023,1024,1025],{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"name":1011,"slug":1012,"type":15},"2026-07-18T05:11:54.496539",{"slug":1028,"name":1028,"fn":1029,"description":1030,"org":1031,"tags":1032,"stars":22,"repoUrl":23,"updatedAt":1039},"blueprint","build reusable Airflow task group templates","Define reusable Airflow task group templates with Pydantic validation and compose DAGs from YAML. Use when creating blueprint templates, composing DAGs from YAML, validating configurations, or enabling no-code DAG authoring for non-engineers.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1033,1034,1035,1036],{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"name":933,"slug":934,"type":15},{"name":1037,"slug":1038,"type":15},"Templates","templates","2026-04-06T18:01:45.361425",{"slug":1041,"name":1041,"fn":1042,"description":1043,"org":1044,"tags":1045,"stars":22,"repoUrl":23,"updatedAt":1052},"checking-freshness","check data freshness in warehouses","Quick data freshness check. Use when the user asks if data is up to date, when a table was last updated, if data is stale, or needs to verify data currency before using it.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1046,1047,1048,1051],{"name":13,"slug":14,"type":15},{"name":889,"slug":36,"type":15},{"name":1049,"slug":1050,"type":15},"Data Quality","data-quality",{"name":933,"slug":934,"type":15},"2026-04-06T18:02:02.138565"]