Skippr Docs

Appearance

Troubleshooting ​

General issues ​

skippr.yml not found ​

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

Need to reset a pipeline ​

If you want to clear Skippr-owned state for one configured pipeline and start fresh, run:

bash
skippr reset --pipeline <name>

This will prompt you to type yes, then remove that pipeline's Skippr runtime and modeling state. It does not delete source data, warehouse data, or schema sink resources.

dbt: command not found ​

Activate the Python virtual environment before running skippr:

bash
source .venv/bin/activate
dbt --version

If dbt is not installed:

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

LLM errors (401 / timeouts) ​

  • The LLM key is provided by the server after authentication. If you see a 401 from the LLM, check that your Skippr account is active and has credits.
  • If you set LLM_API_KEY to use your own key, confirm it is valid and has not expired.
  • If requests timeout on slow networks or long-running model calls, increase LLM_HTTP_TIMEOUT_SECS in the environment.

Modeling resumes an old run ​

By default, skippr model --pipeline <name> resumes the latest modeling thread for that pipeline. If that thread is stale or you want a clean attempt, run:

bash
skippr model --pipeline <name> --no-resume

API key errors (401 / "API key exchange failed") ​

  • Confirm SKIPPR_API_KEY is set to a valid sk_live_… key.
  • The key may have been revoked — check with skippr user list-api-keys.
  • If the key was recently created, wait a few seconds for propagation.
  • Check the auth service URL: SKIPPR_AUTH_URL defaults to https://auth.skippr.io.

"No credits remaining" ​

Your account balance is zero. Add funds to continue:

bash
skippr user buy-credits --amount 25

Sync stalls with no output ​

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

CauseFix
Warehouse connection hangingCheck credentials and network access
Source credentials missingVerify environment variables for your source

Input not found ​

Pass the configured pipeline name explicitly:

bash
skippr sync --pipeline <name> --once

dbt deps needed ​

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

bash
source .venv/bin/activate
dbt deps

Provider-specific issues ​

See the connect guide for your provider: