Troubleshooting

General issues

skippr-dbt.yaml not found

Run skippr-dbt init <project> in the working directory first.

dbt: command not found

Activate the Python virtual environment before running skippr-dbt:

source .venv/bin/activate
dbt --version

If dbt is not installed:

pip install dbt-core dbt-snowflake   # or dbt-bigquery

skippr: command not found

The skippr binary is not on PATH. Download it from the releases page and place it on your PATH.

LLM errors (401 / timeouts)

• Confirm LLM_API_KEY is set and valid.
• If requests timeout, set LLM_HTTP_TIMEOUT_SECS=120 in the environment.
• If output is truncated, set LLM_MAX_TOKENS=8192.

Sync stalls with no output

The extract-and-load step produced no output within the idle timeout. Common causes:

Cause	Fix
Warehouse connection hanging	Check credentials and network access
Source credentials missing	Verify environment variables for your source

dbt deps needed

After the first run, skippr-dbt generates a packages.yml in the dbt project. If dbt reports missing packages, run:

cd .skippr-dbt/local/dev/<project>/dbt
dbt deps

Provider-specific issues

See the connect guide for your provider:

• Snowflake troubleshooting
• BigQuery troubleshooting
• MSSQL troubleshooting
• S3 troubleshooting