The problem: some package managers just warn you if peerDependencies are not met. The package is aimed to cover this moment in CI
# To get help
npx validate-deps --help
# Typical usage to validate scope packages
npx validate-deps --matchesToValidateDeps "@my-scope/*"
To debug you can use VALIDATE_PEERDEPS_LOG_LEVEL environment variable (just set it to debug or trace and you'll see all the details).