Keep YAML small by moving logic into versioned scripts.
Section: Make pipelines maintainable
Wrap repeated commands in repo scripts
bash
bash
./scripts/ci/install.sh
./scripts/ci/test.sh
./scripts/ci/build.shExplanation
Thin YAML plus reusable scripts is often easier to test and review than giant inline shell blocks.
Learn the surrounding workflow
Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.
Related commands
Same sheet · prioritizing Make pipelines maintainable
Use predictable workflow names
Name workflows by concern or application area.
Expose pipeline health publicly
Add workflow status badges to docs or README files.
Generate jobs per package
Drive job fan-out from changed package lists or matrix inputs.