timeback-sdk-skills

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.