superbuilders

Set up browser-side activity tracking using the Timeback SDK's Activity class. Covers React, Vue, Svelte, and Solid adapters, plus framework-agnostic createClient. Handles the full activity lifecycle — start, pause, resume, end with metrics, automatic heartbeats, and visibility-aware time tracking. Always TypeScript, even when the backend is Python. Use when a browser app needs to track learning activities and report XP.

Initialize a project for Timeback integration. Detects the project setup (TypeScript or Python), configures environment variables, and guides the developer through CLI setup (credentials, config, course provisioning). No packages are installed and no code is generated — those steps are handled by the timeback-server skill. Use when a developer wants to set up Timeback in their project for the first time.

Full end-to-end Timeback integration. Discovers the app's domain (subjects, grades, activities, auth system), detects the language and architecture, then delegates to the correct sub-skills to wire everything up. After running this, the app reports XP, matches users by email, tracks time-on-task, and fires Caliper events automatically. Use when a developer wants a complete Timeback integration in one step.

Migrate an app from direct Timeback API calls to the SDK. Scans for raw HTTP calls (OAuth token management, OneRoster queries, Caliper event sends, Edubridge/QTI/PowerPath calls), proposes an SDK equivalent for each supported direct call and flags unsupported or ambiguous cases for developer review, generates or updates timeback.config.json to reference existing Timeback courses only, and incrementally replaces approved direct calls with SDK methods while preserving behavior and verifying each category before cleanup. This is NOT the integrate flow — the app is already working with Timeback, we're swapping the plumbing.

Set up the Timeback server SDK in a TypeScript or Python project. Installs the right package, discovers the auth system, creates the server SDK instance with identity config, mounts the framework adapter, and wires server-side activity.record() for server-only apps. Handles both TypeScript (@timeback/sdk) and Python (timeback-sdk or timeback-core) with framework-specific adapters. Use when a developer needs to set up Timeback's server-side infrastructure.

Sync all Playcademy skills to their latest versions, including any newly added skills. Run this whenever the team announces skill updates, or periodically to stay current.

Fetch the latest Playcademy team standards and apply them to this repo's AGENTS.md. Handles first-time setup (creating AGENTS.md, integrating with existing agent files) and subsequent syncs (replacing the team standards block in place). Run this whenever the team announces updated standards.

Reorganize files within a package or feature directory for better maintainability and scannability. Use when the user says file structure feels disorganized, asks to reorganize or restructure a directory, or wants to improve how files are grouped within a package.

Manages hbot monorepo packages using the workspace CLI in non-interactive command-line mode. Use when creating, removing, listing, cleaning packages, or running checks from terminal-only agents.