.claude/skills/pikku-backblaze/SKILL.md
Use when setting up Backblaze B2 file storage in a Pikku app. Covers B2Content for file uploads, downloads, and signed URLs. TRIGGER when: code uses B2Content, user asks about Backblaze B2, or @pikku/backblaze. DO NOT TRIGGER when: user asks about S3 storage (use pikku-aws).
npx skillsauth add pikkujs/pikku pikku-backblazeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
@pikku/backblaze provides Backblaze B2-backed file storage implementing the ContentService interface.
yarn add @pikku/backblaze
B2Contentimport { B2Content } from '@pikku/backblaze'
const content = new B2Content(
config: B2ContentConfig,
logger: Logger
)
Methods:
signContentKey(key: string, dateLessThan: Date): Promise<string> — Sign a content keysignURL(url: string, dateLessThan: Date): Promise<string> — Sign a URLgetUploadURL(fileKey: string, contentType: string): Promise<{ uploadUrl, assetKey, uploadMethod?, uploadHeaders? }> — Get upload URLwriteFile(assetKey: string, stream: ReadableStream): Promise<boolean> — Write filecopyFile(assetKey: string, fromAbsolutePath: string): Promise<boolean> — Copy local file to B2readFile(assetKey: string): Promise<ReadableStream> — Read file as streamreadFileAsBuffer(assetKey: string): Promise<Buffer> — Read file as bufferdeleteFile(fileName: string): Promise<boolean> — Delete fileimport { B2Content } from '@pikku/backblaze'
const createSingletonServices = pikkuServices(async (config) => {
const logger = new PinoLogger()
const content = new B2Content(
{
applicationKeyId: config.b2KeyId,
applicationKey: config.b2AppKey,
bucketId: config.b2BucketId,
cdnUrl: config.b2CdnUrl,
},
logger
)
return { config, logger, content }
})
documentation
Standard cleanup to run right after a Pikku template is cloned or scaffolded into a new project. TRIGGER when: a Pikku template was just cloned/scaffolded (via `pikku create`, `git clone <template>`, or the user says "I cloned the kanban template / starter / template"), or the working tree still looks like an untouched template (template README, placeholder `@project/*` name in package.json). DO NOT TRIGGER when: working in an established project mid-feature, or editing the template repo itself.
development
Make a Pikku frontend work in both English (LTR) and Arabic / right-to-left languages. Direction is derived from the active locale, applied once at the document root, and the layout mirrors itself — but only if styling is written flow-relative (margin-inline-start, text-align: start, Mantine ms/me) instead of left/right. TRIGGER when: adding Arabic (or Hebrew/Farsi/Urdu), asked to "support RTL / right-to-left / bidi / mirror the layout", or writing layout styles in an app that may run RTL. Builds on pikku-i18n (an RTL language is just another locale file). DO NOT TRIGGER for backend functions or for LTR-only copy changes.
development
Wire i18n into a Pikku frontend (Vite SPA, Vite SSR, or Next.js app-router) with react-i18next + i18next. English by default, every user-facing string goes through a `t()` token, and additional languages are served under `/de` `/es` URL prefixes. TRIGGER when: scaffolding or editing a frontend and writing user-facing text, adding a second language, or asked to "make this translatable / use tokens / add i18n". DO NOT TRIGGER for backend functions, error messages thrown from functions, or log output.
development
Use when translating an n8n Code node body into a real Pikku function body. Triggered when the user opens or points at a stub generated by @pikku/n8n-import (look for `STUB — generated from n8n Code node` in the file's JSDoc), or when the user says 'translate this n8n code', 'port this n8n code node', 'finish the codeStub__... function', etc. The stub file is a `pikkuSessionlessFunc` with a Zod input/output, a JSDoc preserving the original n8n JavaScript verbatim, and a `throw new Error('… — implement me')` body.