firtoz/cf-worker-rpc-turbo
agents/skills/cf-worker-rpc-turbo/SKILL.md
workers/rpc.ts for WorkerRef or DO RPC types, package exports, cross-worker type imports without Turbo cycles, and root dev/destroy wiring. Use when adding WorkerRef, WorkerStub, workers/rpc.ts, turbo circular dependency warnings, or a new app missing from root bun run dev.
$ install --global
skillsauthnpx skillsauth add firtoz/cf-multiworker-starter-kit cf-worker-rpc-turboInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 4, 2026, 2:15 AM270.2s1 file scanned
SKILL.md
- name:
- cf-worker-rpc-turbo
- description:
- workers/rpc.ts for WorkerRef or DO RPC types, package exports, cross-worker type imports without Turbo cycles, and root dev/destroy wiring. Use when adding WorkerRef, WorkerStub, workers/rpc.ts, turbo circular dependency warnings, or a new app missing from root bun run dev.
Cross-worker RPC and Turbo monorepo wiring
When to use
- Typing
WorkerRef<Rpc>,WorkerStub<Rpc>, orDurableObjectNamespace<DoRpc>. - Adding durable-objects/*/workers/rpc.ts (or equivalent).
- Turbo reports circular package dependency between two worker packages.
- A new
durable-objects/*or worker package does not start withbun run devfrom root, orturbo run destroy:*order is wrong.
workers/rpc.ts rules
-
Keep it env-free — Only
export type+Rpc.*Brandedintersections. Noimportfrom../env(avoids extraEnvwhen another package typechecks this file). -
Exports — In that package package.json:
"./workers/rpc": "./workers/rpc.ts". Re-export from./alchemywithexport type { … }when consumers only need the main entry (optional). -
Alchemy — Use the exported RPC type:
DurableObjectNamespace<YourDoRpc>,WorkerRef<OtherWorkerRpc>, etc.
Cyclic stubs / refs (ping-do ↔ other-worker)
When two worker packages WorkerRef / WorkerStub each other to avoid ./alchemy value-import cycles, paste no drift service / name strings derived from omitDefaultPhysicalWorkerScriptName(peerAlchemyAppId, app.stage) with DEFAULT_WORKER_RESOURCE_ID/ALCHEMY_APP_IDS from alchemy-utils/worker-peer-scripts.
Cross-package imports (avoid Turbo / npm cycles)
- Prefer one
workspace:*direction between two siblings (e.g.ping-do→other-workerforimport type { OtherWorkerRpc } from "other-worker/alchemy"). - The other package: relative
import typefrom../<sibling>/workers/rpc(notfrom "<sibling>/alchemy") so both sides are notworkspacedeps of each other for types. - If both must depend on each other, Turbo’s package graph can cycle—restructure to one-way + relative, or duplicate a minimal type (last resort).
Root bun run dev — explicit filters
- package.json
devusesturbo run dev --filter=@internal/web --filter=.... Add--filter=<new-package-name>for each new top-level Alchemy app or it will not run in the root dev TUI.
Destroy order
- In turbo.json, new worker apps that depend on the web should have
<pkg>#destroy:prod,#destroy:staging, and#destroy:previeweach withdependsOnon the matching@internal/web#destroy:*so the web is destroyed first (match existingping-do#destroy:*,other-worker#destroy:*, etc.).
See also
- cf-durable-object-package — alchemy + env inside one package.
- cf-web-alchemy-bindings — web
ReactRouterbindings andapps/web/alchemy.run.ts.
Related Skills
firtoz/multiworker-workflow
development
VerifiedTrustedCommunity
Repo-root commands, typegen and typecheck cadence, lint, deploy, adding packages with bun, and Alchemy app layout. Use at the start of a task, before PR, or when choosing turbo/typegen commands.
8SKILL.mdUpdated May 4, 2026
firtoz/multiworker-gotchas
development
VerifiedTrustedCommunity
Fork and template gotchas (env import, routes, typegen, forms, D1, Turbo, HMR, new DO packages). Use when working on apps/web or durable-objects, or when behavior diverges from this stack’s conventions.
8SKILL.mdUpdated May 4, 2026
firtoz/turborepo
testing
VerifiedTrustedCommunity
Turborepo task configuration patterns for monorepo management. Use when configuring turbo.json tasks, setting up task dependencies, managing cache inputs/outputs, or working with cross-package dependencies in the monorepo.
8SKILL.mdUpdated Apr 27, 2026
firtoz/routing
development
VerifiedTrustedCommunity
React Router v7 routing patterns and environment variable configuration. Use whenever you touch React Router–related code (routes, links, params, loaders, actions, route config, or env in route context).
8SKILL.mdUpdated Apr 27, 2026