From koha-contributor
Build Koha frontend assets (CSS, JS, OpenAPI spec) inside the KTD container. Use after editing SCSS, Vue components, or api/v1/swagger/*.yaml. After swagger changes you must also run restart_all to reload services — yarn build alone is not enough.
How this skill is triggered — by the user, by Claude, or both
Slash command
/koha-contributor:koha-buildThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Build Koha assets inside KTD.
Build Koha assets inside KTD.
Arguments: $ARGUMENTS (optional — css, js, prod, or omit for full build)
| Changed | Command |
|---|---|
*.scss only | yarn css:build (faster) |
*.vue / *.js only | yarn js:build (faster) |
api/v1/swagger/*.yaml (OpenAPI) | yarn build then restart_all (mandatory — see below) |
| Mixed or unsure | yarn build |
| Production / packaging | yarn build:prod |
If the user didn't specify and edited several file types, default to
yarn build.
ktd --name "${KTD_INSTANCE:-kohadev}" --shell --run 'yarn build'
Substitute yarn css:build, yarn js:build, or yarn build:prod as needed.
Edits to api/v1/swagger/*.yaml are not picked up by yarn build alone —
the running Mojolicious workers cache the compiled spec. Restart services
after the build:
ktd --name "${KTD_INSTANCE:-kohadev}" --shell --run 'yarn build && restart_all'
Without restart_all the API will still serve the old spec and your tests
will fail with confusing schema-mismatch errors. This is the single most
common "build looks fine but tests fail" trap.
For tight feedback loops while editing SCSS or JS, run in the background:
ktd --name "${KTD_INSTANCE:-kohadev}" --shell --run 'yarn css:watch' # or yarn js:watch
The user should run watch mode in a separate terminal — don't background it from a skill invocation.
Report: which target ran, build duration if surfaced, and whether
restart_all was triggered. If the build failed, surface the first error
(usually a missing import, syntax error, or YAML parse error in swagger).
npx claudepluginhub mrenvoize/koha-contributor --plugin koha-contributorProvides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.