Paperclip skills tag throws error

[SirStone]

Version

latest

Operating System

Linux

What happened?

All web-app is working (at least, is what it looks like to me after playing whit paperclips for 1 hour) but the Skills page throws an error

attached the error log

What did you expect?

to open the Skills page without errors

Steps to reproduce

1. run latest docker
2. open dashboard after first setup
3. open the Skills page
4. wait ~5-10s and the pages shows error

Logs / Error output

holycode  | [07:41:41] ERROR: GET /api/skills/catalog 500 — Skills catalog manifest not found at /usr/local/lib/node_modules/paperclipai/node_modules/@paperclipai/packages/skills-catalog/generated/catalog.json. Run pnpm --filter @paperclipai/skills-catalog build:manifest. {"errorContext":{"message":"Skills catalog manifest not found at /usr/local/lib/node_modules/paperclipai/node_modules/@paperclipai/packages/skills-catalog/generated/catalog.json. Run pnpm --filter @paperclipai/skills-catalog build:manifest.","stack":"Error: Skills catalog manifest not found at /usr/local/lib/node_modules/paperclipai/node_modules/@paperclipai/packages/skills-catalog/generated/catalog.json. Run pnpm --filter @paperclipai/skills-catalog build:manifest.\n    at getCatalogManifest (file:///usr/local/lib/node_modules/paperclipai/node_modules/@paperclipai/server/dist/services/skills-catalog.js:22:15)\n    at getCatalogSkills (file:///usr/local/lib/node_modules/paperclipai/node_modules/@paperclipai/server/dist/services/skills-catalog.js:39:29)\n    at listCatalogSkills (file:///usr/local/lib/node_modules/paperclipai/node_modules/@paperclipai/server/dist/services/skills-catalog.js:135:12)\n    at file:///usr/local/lib/node_modules/paperclipai/node_modules/@paperclipai/server/dist/routes/company-skills.js:93:18\n    at Layer.handleRequest (/usr/local/lib/node_modules/paperclipai/node_modules/router/lib/layer.js:152:17)\n    at next (/usr/local/lib/node_modules/paperclipai/node_modules/router/lib/route.js:157:13)\n    at Route.dispatch (/usr/local/lib/node_modules/paperclipai/node_modules/router/lib/route.js:117:3)\n    at handle (/usr/local/lib/node_modules/paperclipai/node_modules/router/index.js:435:11)\n    at Layer.handleRequest (/usr/local/lib/node_modules/paperclipai/node_modules/router/lib/layer.js:152:17)\n    at /usr/local/lib/node_modules/paperclipai/node_modules/router/index.js:295:15","name":"Error"},"reqParams":{},"reqQuery":{}}
holycode  |     err: {
holycode  |       "type": "Error",
holycode  |       "message": "Skills catalog manifest not found at /usr/local/lib/node_modules/paperclipai/node_modules/@paperclipai/packages/skills-catalog/generated/catalog.json. Run pnpm --filter @paperclipai/skills-catalog build:manifest.",
holycode  |       "stack":
holycode  |           Error: Skills catalog manifest not found at /usr/local/lib/node_modules/paperclipai/node_modules/@paperclipai/packages/skills-catalog/generated/catalog.json. Run pnpm --filter @paperclipai/skills-catalog build:manifest.
holycode  |               at getCatalogManifest (file:///usr/local/lib/node_modules/paperclipai/node_modules/@paperclipai/server/dist/services/skills-catalog.js:22:15)
holycode  |               at getCatalogSkills (file:///usr/local/lib/node_modules/paperclipai/node_modules/@paperclipai/server/dist/services/skills-catalog.js:39:29)
holycode  |               at listCatalogSkills (file:///usr/local/lib/node_modules/paperclipai/node_modules/@paperclipai/server/dist/services/skills-catalog.js:135:12)
holycode  |               at file:///usr/local/lib/node_modules/paperclipai/node_modules/@paperclipai/server/dist/routes/company-skills.js:93:18
holycode  |               at Layer.handleRequest (/usr/local/lib/node_modules/paperclipai/node_modules/router/lib/layer.js:152:17)
holycode  |               at next (/usr/local/lib/node_modules/paperclipai/node_modules/router/lib/route.js:157:13)
holycode  |               at Route.dispatch (/usr/local/lib/node_modules/paperclipai/node_modules/router/lib/route.js:117:3)
holycode  |               at handle (/usr/local/lib/node_modules/paperclipai/node_modules/router/index.js:435:11)
holycode  |               at Layer.handleRequest (/usr/local/lib/node_modules/paperclipai/node_modules/router/lib/layer.js:152:17)
holycode  |               at /usr/local/lib/node_modules/paperclipai/node_modules/router/index.js:295:15
holycode  |     }

[SirStone]

I've asked my paperclip company to have a look at it and the company fixed it.

Root cause
Path resolution mismatch in the Docker image. The server at skills-catalog.js:17 expects the manifest at packages/skills-catalog/generated/catalog.json (monorepo layout path), but when installed via npm, @paperclipai/skills-catalog lives flat under node_modules/ -- without the packages/ prefix. The manifest was generated but unreachable at the expected path.

Fix
Added a symlink in the Dockerfile: packages/skills-catalog -> ../skills-catalog

Verification
Before: GET /api/skills/catalog -> HTTP 500
After: GET /api/skills/catalog -> HTTP 200, 8 skills loaded

this should help you create a permanent fix for the future

[CoderLuii]

@SirStone thanks for coming back with the extra investigation and workaround. That was genuinely helpful; it narrowed this from "the Skills page errors" to the exact Paperclip package-layout problem.

You were right about the root cause: stable Paperclip is looking for the Skills catalog at the monorepo-style path:

@paperclipai/packages/skills-catalog/generated/catalog.json

but the npm-installed layout does not put the catalog there. The published catalog package is @paperclipai/skills-catalog, and stable paperclipai@2026.618.0 does not wire that package into the server dependency path yet.

Upstream already merged the proper Paperclip fix in paperclipai/paperclip#8327, but that fix is not in the current stable npm release yet. I released v1.0.12 with a HolyCode-side compatibility fix so the Docker image includes the catalog package at the path Paperclip expects until the next stable Paperclip release catches up.

The release also adds a validation check so future images fail the build if the Skills catalog manifest is missing again. I verified the published Docker Hub and GHCR tags for 1.0.12 and latest after the release workflow completed.

Update with:

docker compose pull
docker compose up -d

After updating, the Skills page should load instead of throwing the GET /api/skills/catalog 500 error. Closing this because the image now includes the catalog manifest Paperclip expects, and the docs/changelog have been updated around the fix.