timeback-migrate

Migrate raw HTTP Timeback integrations to the official SDK incrementally.

2|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/superbuilders/timeback-sdk-skills --skill timeback-migrate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: timeback-migrate
Source: https://github.com/superbuilders/timeback-sdk-skills/tree/main/skills/timeback/timeback-migrate
Command: npx skills add https://github.com/superbuilders/timeback-sdk-skills --skill timeback-migrate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrate an existing Timeback integration that uses raw HTTP calls, custom OAuth token handling, and manual Caliper/OneRoster requests into the official Timeback SDK without changing product behavior.

Core Features & Use Cases

  • Comprehensive Audit: Scans the codebase for OAuth token management, OneRoster queries, Caliper event sends, Edubridge/QTI/PowerPath calls, and records their locations and contexts.
  • Config & SDK Setup: Proposes a timeback.config.json that references existing Timeback courses, maps environment variables, and guides installing and mounting the server SDK adapter.
  • Incremental Migration with Gates: Proposes SDK equivalents, migrates approved calls in dependency order, preserves behavior, removes redundant token management, and enforces decision gates for developer approval.
  • Verification & Cleanup: Runs checks to ensure no approved raw calls remain, validates types/tests, and documents excluded or ambiguous cases for manual review.

Quick Start

Run a Phase 1 audit to inventory direct Timeback calls, create timeback-migration.md, and present the manifest at Gate 1 for developer confirmation.

Frequently Asked Questions about timeback-migrate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate raw Timeback HTTP calls to the SDK without changing product behavior?

To migrate Timeback calls to the SDK without behavior changes, run a Phase 1 audit to inventory direct OAuth, OneRoster, and Caliper requests. The process then proposes SDK equivalents, migrates approved calls in dependency order, and verifies that no raw calls remain before cleanup.

Can I incrementally swap custom OAuth token handling for the Timeback SDK?

Yes, you can incrementally swap custom OAuth token handling for the Timeback SDK. The migration proposes SDK equivalents, migrates approved calls in dependency order, and removes redundant token management only after developer confirmation at gated checkpoints.

What is the best way to audit existing OneRoster and Caliper API integrations before migration?

The best way to audit existing OneRoster and Caliper integrations is running a Phase 1 audit. This scans the codebase for manual requests, OAuth token management, and Edubridge or PowerPath calls, recording their locations and contexts into a migration manifest for developer confirmation.

Does the Timeback SDK migration support Edubridge, QTI, and PowerPath calls?

Yes, the Timeback SDK migration supports Edubridge, QTI, and PowerPath calls. The audit scans the codebase for these specific direct calls, proposes official SDK equivalents, and migrates them incrementally while preserving existing product behavior.

Do I need Timeback API credentials and course IDs to migrate to the SDK?

Yes, you need Timeback API credentials or course IDs to migrate to the SDK. Config setup references existing Timeback courses and maps environment variables to generate a timeback.config.json, requiring codebase access and developer confirmation at gated checkpoints to proceed.

How are ambiguous Caliper or OneRoster API calls handled during SDK migration?

Ambiguous Caliper or OneRoster calls are documented for manual review during verification. The migration enforces decision gates requiring developer approval before proceeding, ensuring excluded or ambiguous cases are explicitly recorded rather than automatically converted.