Troubleshooting

Check the installed version

1npm 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. 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.