| name | vibekit |
| description | Add @randroids-dojo/vibekit (https://github.com/Randroids-Dojo/VibeKit) as a dependency and look up per-module usage patterns. Optional companion to the spiral skill; replaceable with a different shared-library skill if a project prefers another component source. Slash commands /vibekit-add and /vibekit-cookbook live under commands/. |
VibeKit
@randroids-dojo/vibekit is the in-house reusable-component library this workspace's game projects share. The default entry exposes framework-agnostic client modules (virtual-joystick, editor-history, confetti, rng, math, storage); the ./server subpath exposes Node-only helpers (kv, sign, rate-limit) locked to @upstash/redis + node:crypto.
This skill is the bootstrap-and-cookbook layer for VibeKit. It is intentionally optional and lives alongside spiral (structural-discipline scaffold) and randroid:loop (research / implement loops) the same way: spiral defers to randroid:loop for execution; spiral defers to this skill for VibeKit-specific bootstrap and component usage. A project that prefers a different shared library swaps this skill out without touching spiral's gate, ledger, or loop machinery.
When to invoke
/vibekit add: from inside a project repo. Adds @randroids-dojo/vibekit as a github: tag-pinned dependency in package.json, and prints (does not auto-write) the matching DEPENDENCY_LEDGER.md entry to paste into the project's spiral ledger./vibekit cookbook: surfaces the per-module usage cookbook (docs/cookbook.md in this skill). Use when wiring up a specific module (joystick, storage, kv, sign, ...) or when the kit's own README isn't enough and you want the "how to compose this in a Next.js / React project" view.
How this skill relates to spiral
- Spiral defines the Dependency Upgrade Gate, the ledger format, and the upgrade procedure (read CHANGELOG, branch, bump, type-check, test, build, smoke, PR with
chore(deps): title). It does not know about any specific dep. See plugins/spiral/templates/DEPENDENCY_LEDGER.md.
- VibeKit (this skill) supplies the worked example for the spiral ledger and the cookbook for wiring up each module. A project that uses VibeKit gets a richer ledger entry (with import snippets) and a cookbook reference; a project that prefers a different shared library follows the same spiral procedure with that library's own skill.
- Randroid loop command is the slice executor. It reads spiral's ledgers + AGENTS.md, picks the next slice, branches, implements, opens a PR. When a slice is "bump VibeKit from vX to vY" it follows spiral's procedure; this skill's cookbook tells it which migration patterns are common per module.
Composition
spiral (methodology + scaffold + Dependency Upgrade Gate)
├─ defers execution to randroid:loop
└─ defers VibeKit-specific bootstrap + cookbook to vibekit (this skill)
Replace any leg without affecting the others.
Architecture
vibekit/
├── SKILL.md # This file
├── README.md # Human-facing one-pager
├── .claude-plugin/
│ └── plugin.json # Plugin metadata
├── commands/
│ ├── vibekit-add.md # /vibekit add slash command
│ └── vibekit-cookbook.md # /vibekit cookbook slash command
├── docs/
│ └── cookbook.md # Per-module usage cookbook
└── scripts/
└── add.sh # Bootstrap into a target repo
What's in the kit
The kit lives at https://github.com/Randroids-Dojo/VibeKit. Releases are cut by release-please on every push to its main; tags follow vX.Y.Z. Pre-1.0 the kit treats every feat: as a patch via bump-patch-for-minor-pre-major, so any patch tag may carry signature changes; consumers read the CHANGELOG between pinned and target.
Default entry (@randroids-dojo/vibekit):
virtual-joystick. Float-where-you-tap touch joystick state.editor-history. Generic EditorHistory<T> undo / redo stack.confetti. Pure particle simulation for celebration overlays.rng. Seeded Mulberry32 PRNG plus range, pick, gauss.math. TAU, clamp, lerp, inverseLerp, remap, smoothstep, wrapAngle.storage. Defensive zod-validated localStorage helpers with cross-tab + same-tab change events.
Server entry (@randroids-dojo/vibekit/server, Node-only):
kv. getKv cached singleton (null on missing env), readKv<T> zod-validated, writeKv with optional TTL, removeKv, resetKvForTesting.sign. HMAC-SHA256 signToken / verifyToken with constant-time comparison.rate-limit. incrementWithExpiry fixed-window primitive (returns post-increment count).
