Better Sqlite3 Rebuild
- 57 installs
- 193 repo stars
- Updated April 1, 2026
- mattpocock/ai-engineer-workshop-2026-project
Recover a local app that crashes on better-sqlite3 load after you change Node versions or pull fresh node_modules.
About
better-sqlite3-rebuild is a narrow agent skill that tells your coding agent to fix the most common better-sqlite3 failure mode: the native addon was built for a different Node.js ABI than the one you are running now. Solo and indie builders hit this constantly when switching nvm versions, upgrading Node for a deploy target, or cloning a repo on a new machine. Instead of burning context on explanations, the skill encodes a single corrective action—run `npm rebuild` in the project—and then retry. It is aimed at anyone shipping Node backends or CLIs that persist data with better-sqlite3, especially during workshop-style rapid iteration where Node versions move faster than documentation. The skill does not replace diagnosing corrupt databases or wrong SQL; it only addresses native binding load errors. Pair it with your normal test or dev-server loop so the agent rebuilds proactively whenever the error signature appears.
- Triggers on better-sqlite3 native module and NODE_MODULE_VERSION mismatch errors
- Runs `npm rebuild` immediately without asking the user first
- Retries the failing operation after rebuild
- Scoped to better-sqlite3 binding failures, not generic SQLite SQL debugging
Better Sqlite3 Rebuild by the numbers
- 57 all-time installs (skills.sh)
- Ranked #300 of 610 Debugging skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
npx skills add https://github.com/mattpocock/ai-engineer-workshop-2026-project --skill better-sqlite3-rebuildAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 57 |
|---|---|
| repo stars | ★ 193 |
| Security audit | 3 / 3 scanners passed |
| Last updated | April 1, 2026 |
| Repository | mattpocock/ai-engineer-workshop-2026-project ↗ |
What it does
Recover a local app that crashes on better-sqlite3 load after you change Node versions or pull fresh node_modules.
Files
better-sqlite3 Rebuild
When you encounter errors related to better-sqlite3 and Node.js version mismatches (e.g. NODE_MODULE_VERSION mismatch, "was compiled against a different Node.js version", native module load failures), proactively fix by running:
npm rebuildDo this without asking the user first - just rebuild and retry.
Related skills
Azure DiagnosticsSystematically diagnose and resolve production issues on Microsoft Azure using official Microsoft guidance.472k1.3kAzure MessagingQuickly diagnose and fix connection, authentication, and message-processing failures when using Azure Event Hubs or Service Bus SDKs.460k1.3k
Use My BrowserWhen their agent task requires access to the live browser session, rendered DOM state, authenticated dashboards, localhost apps, or DevTools-selected elements instea269k72Diagnosing BugsGet a systematic, step-by-step process that surfaces the real root cause instead of guessing at bugs.222k183k
Systematic DebuggingFollow a repeatable four-phase process that forces root-cause discovery before any code changes.197k260k
Safe DebugGet conservative, non-destructive diagnosis of deep learning and agent errors before any code changes are made.161k507FAQ
Is Better Sqlite3 Rebuild safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.