# Troubleshooting

## Check the installed version

```bash
npm ls @qentrah/skills
```

Compare the installed version with the version noted in this guide. Inspect your lockfile before changing dependencies; prerelease behavior may differ between versions.

## Import or module errors

Use only public import paths listed in [API and exports](/docs/npm-skills/reference). Avoid importing guessed paths inside `dist`. ESM-only packages require an ESM-aware application. Install declared peer dependencies in the consuming application.

## Existing skill directory

Without `--force`, preserve the existing installation and choose another destination if needed. `--force` replaces an existing installation. Run `list` first to check the canonical name; use `--cwd` to select the intended project rather than relying on the terminal’s current directory. Network or GitHub access failures can prevent fetching a skill; keep the existing files until the installation succeeds.