From 46c429ec7d7722d2d3ccc4f40c177308a444082c Mon Sep 17 00:00:00 2001
From: studiolxd <hello@studiolxd.com>
Date: Mon, 15 Jun 2026 22:15:06 +0200
Subject: [PATCH] chore: extract skills to studiolxd/scorm-skills; link from
 README + llms.txt

The agent skills now live in their own repo (single source of truth). Remove the duplicated skills/ folder from the monorepo and point to it from the library README and llms.txt.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 packages/scorm/README.md                      | 12 +++
 packages/scorm/llms.txt                       |  1 +
 skills/README.md                              | 43 -----------
 skills/build/agents/scorm-integration.md      | 72 ------------------
 .../.claude-plugin/marketplace.json           | 15 ----
 .../.claude-plugin/plugin.json                |  5 --
 .../skills/scorm-integration/SKILL.md         | 75 ------------------
 skills/build/cursor/scorm-integration.mdc     | 76 -------------------
 skills/scripts/build.mjs                      | 69 -----------------
 skills/source/skill.md                        | 76 -------------------
 10 files changed, 13 insertions(+), 431 deletions(-)
 delete mode 100644 skills/README.md
 delete mode 100644 skills/build/agents/scorm-integration.md
 delete mode 100644 skills/build/claude-plugin/.claude-plugin/marketplace.json
 delete mode 100644 skills/build/claude-plugin/plugins/scorm-integration/.claude-plugin/plugin.json
 delete mode 100644 skills/build/claude-plugin/plugins/scorm-integration/skills/scorm-integration/SKILL.md
 delete mode 100644 skills/build/cursor/scorm-integration.mdc
 delete mode 100644 skills/scripts/build.mjs
 delete mode 100644 skills/source/skill.md

diff --git a/packages/scorm/README.md b/packages/scorm/README.md
index 867e76a..1849719 100644
--- a/packages/scorm/README.md
+++ b/packages/scorm/README.md
@@ -449,6 +449,18 @@ const path: Scorm12CmiPath = 'cmi.core.lesson_status';  // OK
 // const bad: Scorm12CmiPath = 'cmi.core.typo';          // ERROR
 ```
 
+## AI coding agents
+
+Using Claude Code, Cursor, or another AI coding assistant? Add the **[scorm-skills](https://github.com/studiolxd/scorm-skills)** so the agent knows how to use this library:
+
+```
+# Claude Code
+/plugin marketplace add studiolxd/scorm-skills
+/plugin install scorm-integration@studiolxd-scorm
+
+# Cursor: copy cursor/scorm-integration.mdc into your project's .cursor/rules/
+```
+
 ## Additional Documentation
 
 - [SCORM 1.2 vs 2004 Mapping Table](./docs/scorm-mapping-table.md)
diff --git a/packages/scorm/llms.txt b/packages/scorm/llms.txt
index 71a7d57..b49cf22 100644
--- a/packages/scorm/llms.txt
+++ b/packages/scorm/llms.txt
@@ -5,6 +5,7 @@
 > Angular, Svelte, and Web Components. Every API call returns a typed Result.
 
 Install: `npm i @studiolxd/scorm`
+Agent skill (Claude Code / Cursor): https://github.com/studiolxd/scorm-skills
 
 ## Entry points (subpath imports)
 
diff --git a/skills/README.md b/skills/README.md
deleted file mode 100644
index b347596..0000000
--- a/skills/README.md
+++ /dev/null
@@ -1,43 +0,0 @@
-# scorm-skills
-
-Agent instructions that teach AI coding tools how to use `@studiolxd/scorm`.
-
-**One canonical source → many tool formats.** Everything in `build/` is generated;
-edit only `source/skill.md`.
-
-```
-source/skill.md          # the single source of truth (edit this)
-scripts/build.mjs        # generator: source → build/*
-build/                   # generated (do not edit by hand)
-  claude-plugin/         # Claude Code plugin + marketplace
-    .claude-plugin/marketplace.json
-    plugins/scorm-integration/...
-  cursor/scorm-integration.mdc   # Cursor rule
-  agents/scorm-integration.md    # portable baseline (Antigravity, Copilot, generic)
-```
-
-Regenerate after editing the source:
-
-```bash
-node skills/scripts/build.mjs
-```
-
-## Using it per tool
-
-- **Claude Code** — add `skills/build/claude-plugin` as a plugin marketplace (its
-  `.claude-plugin/marketplace.json`), then install the `scorm-integration` plugin.
-  For distribution, publish `build/claude-plugin` as its own public repo.
-- **Cursor** — copy `build/cursor/scorm-integration.mdc` into your project's
-  `.cursor/rules/`.
-- **Other agents (Antigravity, Copilot, …)** — drop `build/agents/scorm-integration.md`
-  into the project (e.g. append to `AGENTS.md`), or point the tool's rules at it.
-
-## Why this is separate from the npm package
-
-The runtime package `@studiolxd/scorm` ships only `dist/` + `llms.txt` — it stays lean.
-Agent skills target a different audience (coding-assistant toolchains) and are
-distributed via marketplaces/rules, not `npm install`. Per the plan they live in a
-dedicated location (here, intended to be published as `studiolxd/scorm-skills`).
-
-> Note: marketplace/plugin manifest schemas evolve — verify `marketplace.json` and
-> `plugin.json` against the current Claude Code plugin docs before publishing.
diff --git a/skills/build/agents/scorm-integration.md b/skills/build/agents/scorm-integration.md
deleted file mode 100644
index 33e1154..0000000
--- a/skills/build/agents/scorm-integration.md
+++ /dev/null
@@ -1,72 +0,0 @@
-# scorm-integration
-
-# Using @studiolxd/scorm
-
-`@studiolxd/scorm` is a headless SCORM 1.2/2004 runtime. A framework-agnostic core
-(`createScormSession`) plus thin adapters. Built-in **mock mode** runs without an LMS.
-
-## Pick the entry point
-
-- Vanilla / any framework: `import { createScormSession } from '@studiolxd/scorm'`
-- React: `import { ScormProvider, useScorm, useScormSession } from '@studiolxd/scorm/react'`
-- Vue: `import { useScorm } from '@studiolxd/scorm/vue'`
-- Angular (>=17): `import { provideScorm, SCORM } from '@studiolxd/scorm/angular'`
-- Svelte: `import { createScormStore } from '@studiolxd/scorm/svelte'`
-- Web Component: `import '@studiolxd/scorm/wc'` then `<scorm-session>`
-- CDN `<script>`: global `window.Scorm`
-
-## The golden rules
-
-1. **Always check `.ok` before `.value`.** Every API method returns
-   `Result<T, ScormError>`. Session lifecycle methods return `undefined` when no SCORM
-   API was found (`noLmsBehavior: 'error'`).
-2. **Lifecycle order:** `initialize()` → interact → `commit()` → `terminate()`. Never
-   call data methods before `initialize()`.
-3. **Use mock mode for dev/tests:** `createScormSession('2004', { noLmsBehavior: 'mock' })`.
-4. **A terminated session cannot be re-initialized** (SCORM rule). Create a new session
-   (or remount the React provider with a changed `key`) to start over.
-5. **`version: 'auto'`** detects the host LMS (SCORM 2004 first, then 1.2).
-
-## Canonical vanilla example
-
-```ts
-import { createScormSession } from '@studiolxd/scorm';
-
-const session = createScormSession('auto', { noLmsBehavior: 'mock' });
-session.initialize();
-
-const name = session.api?.getLearnerName();
-if (name?.ok) console.log(name.value);
-
-session.api?.setScore({ raw: 80, min: 0, max: 100 }); // 1.2: raw/min/max must be 0–100
-session.api?.setComplete();
-session.commit();
-session.terminate();
-```
-
-## Lifecycle helpers (don't hand-roll unload handling)
-
-```ts
-import { autoTerminate, autoCommit } from '@studiolxd/scorm';
-const stopTerm = autoTerminate(session);   // init now; commit+terminate on unload/dispose
-const stopCommit = autoCommit(session, 30_000); // flush every 30s
-// later: stopTerm(); stopCommit();
-```
-
-React: `useScormAutoTerminate()` and `useScormAutoCommit(ms)` do this for you.
-
-## Common gotchas (these cause real bugs)
-
-- SCORM 1.2 interactions are **write-only**: `getInteraction()` errors (code 404) in 1.2;
-  only SCORM 2004 can read them back.
-- SCORM 1.2 score `raw/min/max` must be **0–100** (error 405 otherwise). 2004 `scaled`
-  must be **-1..1** (error 407).
-- `setProgressMeasure` is a no-op in SCORM 1.2.
-- `setSessionTime(ms)` takes **milliseconds**; it formats per version internally.
-- `recordInteraction(index, record)` — index is the FIRST argument.
-- `addLearnerComment(comment, location?, timestamp?)` — location before timestamp.
-- SSR (Next.js/Remix): the core is SSR-safe; import `/wc` on the client only.
-
-## ScormError fields
-
-`code`, `errorString`, `operation`, `path`, `diagnostic`, `version`, `apiFound`, `initialized`.
diff --git a/skills/build/claude-plugin/.claude-plugin/marketplace.json b/skills/build/claude-plugin/.claude-plugin/marketplace.json
deleted file mode 100644
index 012850d..0000000
--- a/skills/build/claude-plugin/.claude-plugin/marketplace.json
+++ /dev/null
@@ -1,15 +0,0 @@
-{
-  "name": "studiolxd-scorm",
-  "owner": {
-    "name": "StudioLXD",
-    "url": "https://github.com/studiolxd"
-  },
-  "plugins": [
-    {
-      "name": "scorm-integration",
-      "source": "./plugins/scorm-integration",
-      "description": "Use when integrating SCORM 1.2/2004 in a web app with @studiolxd/scorm — initializing a session, reading/writing CMI data (score, completion, suspend data, interactions, objectives), handling Result errors, or wiring lifecycle/auto-commit across React, Vue, Angular, Svelte, Web Components, or vanilla JS.",
-      "version": "1.0.0"
-    }
-  ]
-}
diff --git a/skills/build/claude-plugin/plugins/scorm-integration/.claude-plugin/plugin.json b/skills/build/claude-plugin/plugins/scorm-integration/.claude-plugin/plugin.json
deleted file mode 100644
index 66aaf9e..0000000
--- a/skills/build/claude-plugin/plugins/scorm-integration/.claude-plugin/plugin.json
+++ /dev/null
@@ -1,5 +0,0 @@
-{
-  "name": "scorm-integration",
-  "description": "Use when integrating SCORM 1.2/2004 in a web app with @studiolxd/scorm — initializing a session, reading/writing CMI data (score, completion, suspend data, interactions, objectives), handling Result errors, or wiring lifecycle/auto-commit across React, Vue, Angular, Svelte, Web Components, or vanilla JS.",
-  "version": "1.0.0"
-}
diff --git a/skills/build/claude-plugin/plugins/scorm-integration/skills/scorm-integration/SKILL.md b/skills/build/claude-plugin/plugins/scorm-integration/skills/scorm-integration/SKILL.md
deleted file mode 100644
index 798352f..0000000
--- a/skills/build/claude-plugin/plugins/scorm-integration/skills/scorm-integration/SKILL.md
+++ /dev/null
@@ -1,75 +0,0 @@
----
-name: scorm-integration
-description: Use when integrating SCORM 1.2/2004 in a web app with @studiolxd/scorm — initializing a session, reading/writing CMI data (score, completion, suspend data, interactions, objectives), handling Result errors, or wiring lifecycle/auto-commit across React, Vue, Angular, Svelte, Web Components, or vanilla JS.
----
-
-# Using @studiolxd/scorm
-
-`@studiolxd/scorm` is a headless SCORM 1.2/2004 runtime. A framework-agnostic core
-(`createScormSession`) plus thin adapters. Built-in **mock mode** runs without an LMS.
-
-## Pick the entry point
-
-- Vanilla / any framework: `import { createScormSession } from '@studiolxd/scorm'`
-- React: `import { ScormProvider, useScorm, useScormSession } from '@studiolxd/scorm/react'`
-- Vue: `import { useScorm } from '@studiolxd/scorm/vue'`
-- Angular (>=17): `import { provideScorm, SCORM } from '@studiolxd/scorm/angular'`
-- Svelte: `import { createScormStore } from '@studiolxd/scorm/svelte'`
-- Web Component: `import '@studiolxd/scorm/wc'` then `<scorm-session>`
-- CDN `<script>`: global `window.Scorm`
-
-## The golden rules
-
-1. **Always check `.ok` before `.value`.** Every API method returns
-   `Result<T, ScormError>`. Session lifecycle methods return `undefined` when no SCORM
-   API was found (`noLmsBehavior: 'error'`).
-2. **Lifecycle order:** `initialize()` → interact → `commit()` → `terminate()`. Never
-   call data methods before `initialize()`.
-3. **Use mock mode for dev/tests:** `createScormSession('2004', { noLmsBehavior: 'mock' })`.
-4. **A terminated session cannot be re-initialized** (SCORM rule). Create a new session
-   (or remount the React provider with a changed `key`) to start over.
-5. **`version: 'auto'`** detects the host LMS (SCORM 2004 first, then 1.2).
-
-## Canonical vanilla example
-
-```ts
-import { createScormSession } from '@studiolxd/scorm';
-
-const session = createScormSession('auto', { noLmsBehavior: 'mock' });
-session.initialize();
-
-const name = session.api?.getLearnerName();
-if (name?.ok) console.log(name.value);
-
-session.api?.setScore({ raw: 80, min: 0, max: 100 }); // 1.2: raw/min/max must be 0–100
-session.api?.setComplete();
-session.commit();
-session.terminate();
-```
-
-## Lifecycle helpers (don't hand-roll unload handling)
-
-```ts
-import { autoTerminate, autoCommit } from '@studiolxd/scorm';
-const stopTerm = autoTerminate(session);   // init now; commit+terminate on unload/dispose
-const stopCommit = autoCommit(session, 30_000); // flush every 30s
-// later: stopTerm(); stopCommit();
-```
-
-React: `useScormAutoTerminate()` and `useScormAutoCommit(ms)` do this for you.
-
-## Common gotchas (these cause real bugs)
-
-- SCORM 1.2 interactions are **write-only**: `getInteraction()` errors (code 404) in 1.2;
-  only SCORM 2004 can read them back.
-- SCORM 1.2 score `raw/min/max` must be **0–100** (error 405 otherwise). 2004 `scaled`
-  must be **-1..1** (error 407).
-- `setProgressMeasure` is a no-op in SCORM 1.2.
-- `setSessionTime(ms)` takes **milliseconds**; it formats per version internally.
-- `recordInteraction(index, record)` — index is the FIRST argument.
-- `addLearnerComment(comment, location?, timestamp?)` — location before timestamp.
-- SSR (Next.js/Remix): the core is SSR-safe; import `/wc` on the client only.
-
-## ScormError fields
-
-`code`, `errorString`, `operation`, `path`, `diagnostic`, `version`, `apiFound`, `initialized`.
diff --git a/skills/build/cursor/scorm-integration.mdc b/skills/build/cursor/scorm-integration.mdc
deleted file mode 100644
index 072bf6d..0000000
--- a/skills/build/cursor/scorm-integration.mdc
+++ /dev/null
@@ -1,76 +0,0 @@
----
-description: Use when integrating SCORM 1.2/2004 in a web app with @studiolxd/scorm — initializing a session, reading/writing CMI data (score, completion, suspend data, interactions, objectives), handling Result errors, or wiring lifecycle/auto-commit across React, Vue, Angular, Svelte, Web Components, or vanilla JS.
-globs: ["**/*.{ts,tsx,js,jsx,vue,svelte}"]
-alwaysApply: false
----
-
-# Using @studiolxd/scorm
-
-`@studiolxd/scorm` is a headless SCORM 1.2/2004 runtime. A framework-agnostic core
-(`createScormSession`) plus thin adapters. Built-in **mock mode** runs without an LMS.
-
-## Pick the entry point
-
-- Vanilla / any framework: `import { createScormSession } from '@studiolxd/scorm'`
-- React: `import { ScormProvider, useScorm, useScormSession } from '@studiolxd/scorm/react'`
-- Vue: `import { useScorm } from '@studiolxd/scorm/vue'`
-- Angular (>=17): `import { provideScorm, SCORM } from '@studiolxd/scorm/angular'`
-- Svelte: `import { createScormStore } from '@studiolxd/scorm/svelte'`
-- Web Component: `import '@studiolxd/scorm/wc'` then `<scorm-session>`
-- CDN `<script>`: global `window.Scorm`
-
-## The golden rules
-
-1. **Always check `.ok` before `.value`.** Every API method returns
-   `Result<T, ScormError>`. Session lifecycle methods return `undefined` when no SCORM
-   API was found (`noLmsBehavior: 'error'`).
-2. **Lifecycle order:** `initialize()` → interact → `commit()` → `terminate()`. Never
-   call data methods before `initialize()`.
-3. **Use mock mode for dev/tests:** `createScormSession('2004', { noLmsBehavior: 'mock' })`.
-4. **A terminated session cannot be re-initialized** (SCORM rule). Create a new session
-   (or remount the React provider with a changed `key`) to start over.
-5. **`version: 'auto'`** detects the host LMS (SCORM 2004 first, then 1.2).
-
-## Canonical vanilla example
-
-```ts
-import { createScormSession } from '@studiolxd/scorm';
-
-const session = createScormSession('auto', { noLmsBehavior: 'mock' });
-session.initialize();
-
-const name = session.api?.getLearnerName();
-if (name?.ok) console.log(name.value);
-
-session.api?.setScore({ raw: 80, min: 0, max: 100 }); // 1.2: raw/min/max must be 0–100
-session.api?.setComplete();
-session.commit();
-session.terminate();
-```
-
-## Lifecycle helpers (don't hand-roll unload handling)
-
-```ts
-import { autoTerminate, autoCommit } from '@studiolxd/scorm';
-const stopTerm = autoTerminate(session);   // init now; commit+terminate on unload/dispose
-const stopCommit = autoCommit(session, 30_000); // flush every 30s
-// later: stopTerm(); stopCommit();
-```
-
-React: `useScormAutoTerminate()` and `useScormAutoCommit(ms)` do this for you.
-
-## Common gotchas (these cause real bugs)
-
-- SCORM 1.2 interactions are **write-only**: `getInteraction()` errors (code 404) in 1.2;
-  only SCORM 2004 can read them back.
-- SCORM 1.2 score `raw/min/max` must be **0–100** (error 405 otherwise). 2004 `scaled`
-  must be **-1..1** (error 407).
-- `setProgressMeasure` is a no-op in SCORM 1.2.
-- `setSessionTime(ms)` takes **milliseconds**; it formats per version internally.
-- `recordInteraction(index, record)` — index is the FIRST argument.
-- `addLearnerComment(comment, location?, timestamp?)` — location before timestamp.
-- SSR (Next.js/Remix): the core is SSR-safe; import `/wc` on the client only.
-
-## ScormError fields
-
-`code`, `errorString`, `operation`, `path`, `diagnostic`, `version`, `apiFound`, `initialized`.
diff --git a/skills/scripts/build.mjs b/skills/scripts/build.mjs
deleted file mode 100644
index 3a23820..0000000
--- a/skills/scripts/build.mjs
+++ /dev/null
@@ -1,69 +0,0 @@
-#!/usr/bin/env node
-// Generate per-tool skill files from the single canonical source (source/skill.md).
-// One source → Claude Code plugin/marketplace, Cursor rule, and a portable baseline.
-// Run: node skills/scripts/build.mjs
-import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
-const raw = readFileSync(resolve(root, 'source/skill.md'), 'utf8');
-
-// Split YAML frontmatter (--- ... ---) from the markdown body.
-const m = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
-if (!m) throw new Error('source/skill.md is missing frontmatter');
-const [, fm, body] = m;
-
-const field = (key) => {
-  const line = fm.split('\n').find((l) => l.startsWith(`${key}:`));
-  return line ? line.slice(key.length + 1).trim() : '';
-};
-const name = field('name');
-const description = field('description');
-const globs = field('globs'); // JSON-ish array literal
-const VERSION = '1.0.0';
-
-const write = (rel, content) => {
-  const out = resolve(root, 'build', rel);
-  mkdirSync(dirname(out), { recursive: true });
-  writeFileSync(out, typeof content === 'string' ? content.trimStart() : JSON.stringify(content, null, 2) + '\n');
-  console.log('wrote', `build/${rel}`);
-};
-
-// 1. Claude Code plugin + marketplace.
-//    Add this repo's build/claude-plugin as a marketplace, then install the plugin.
-write('claude-plugin/.claude-plugin/marketplace.json', {
-  name: 'studiolxd-scorm',
-  owner: { name: 'StudioLXD', url: 'https://github.com/studiolxd' },
-  plugins: [{ name, source: `./plugins/${name}`, description, version: VERSION }],
-});
-write(`claude-plugin/plugins/${name}/.claude-plugin/plugin.json`, {
-  name,
-  description,
-  version: VERSION,
-});
-write(`claude-plugin/plugins/${name}/skills/${name}/SKILL.md`, `---
-name: ${name}
-description: ${description}
----
-
-${body.trim()}
-`);
-
-// 2. Cursor rule — .mdc with description + globs + alwaysApply.
-write(`cursor/${name}.mdc`, `---
-description: ${description}
-globs: ${globs}
-alwaysApply: false
----
-
-${body.trim()}
-`);
-
-// 3. Portable AGENTS-style baseline (Antigravity, Copilot, generic).
-write(`agents/${name}.md`, `# ${name}
-
-${body.trim()}
-`);
-
-console.log('\nDone. One source → Claude plugin, Cursor rule, portable baseline.');
diff --git a/skills/source/skill.md b/skills/source/skill.md
deleted file mode 100644
index 882cbdd..0000000
--- a/skills/source/skill.md
+++ /dev/null
@@ -1,76 +0,0 @@
----
-name: scorm-integration
-description: Use when integrating SCORM 1.2/2004 in a web app with @studiolxd/scorm — initializing a session, reading/writing CMI data (score, completion, suspend data, interactions, objectives), handling Result errors, or wiring lifecycle/auto-commit across React, Vue, Angular, Svelte, Web Components, or vanilla JS.
-globs: ["**/*.{ts,tsx,js,jsx,vue,svelte}"]
----
-
-# Using @studiolxd/scorm
-
-`@studiolxd/scorm` is a headless SCORM 1.2/2004 runtime. A framework-agnostic core
-(`createScormSession`) plus thin adapters. Built-in **mock mode** runs without an LMS.
-
-## Pick the entry point
-
-- Vanilla / any framework: `import { createScormSession } from '@studiolxd/scorm'`
-- React: `import { ScormProvider, useScorm, useScormSession } from '@studiolxd/scorm/react'`
-- Vue: `import { useScorm } from '@studiolxd/scorm/vue'`
-- Angular (>=17): `import { provideScorm, SCORM } from '@studiolxd/scorm/angular'`
-- Svelte: `import { createScormStore } from '@studiolxd/scorm/svelte'`
-- Web Component: `import '@studiolxd/scorm/wc'` then `<scorm-session>`
-- CDN `<script>`: global `window.Scorm`
-
-## The golden rules
-
-1. **Always check `.ok` before `.value`.** Every API method returns
-   `Result<T, ScormError>`. Session lifecycle methods return `undefined` when no SCORM
-   API was found (`noLmsBehavior: 'error'`).
-2. **Lifecycle order:** `initialize()` → interact → `commit()` → `terminate()`. Never
-   call data methods before `initialize()`.
-3. **Use mock mode for dev/tests:** `createScormSession('2004', { noLmsBehavior: 'mock' })`.
-4. **A terminated session cannot be re-initialized** (SCORM rule). Create a new session
-   (or remount the React provider with a changed `key`) to start over.
-5. **`version: 'auto'`** detects the host LMS (SCORM 2004 first, then 1.2).
-
-## Canonical vanilla example
-
-```ts
-import { createScormSession } from '@studiolxd/scorm';
-
-const session = createScormSession('auto', { noLmsBehavior: 'mock' });
-session.initialize();
-
-const name = session.api?.getLearnerName();
-if (name?.ok) console.log(name.value);
-
-session.api?.setScore({ raw: 80, min: 0, max: 100 }); // 1.2: raw/min/max must be 0–100
-session.api?.setComplete();
-session.commit();
-session.terminate();
-```
-
-## Lifecycle helpers (don't hand-roll unload handling)
-
-```ts
-import { autoTerminate, autoCommit } from '@studiolxd/scorm';
-const stopTerm = autoTerminate(session);   // init now; commit+terminate on unload/dispose
-const stopCommit = autoCommit(session, 30_000); // flush every 30s
-// later: stopTerm(); stopCommit();
-```
-
-React: `useScormAutoTerminate()` and `useScormAutoCommit(ms)` do this for you.
-
-## Common gotchas (these cause real bugs)
-
-- SCORM 1.2 interactions are **write-only**: `getInteraction()` errors (code 404) in 1.2;
-  only SCORM 2004 can read them back.
-- SCORM 1.2 score `raw/min/max` must be **0–100** (error 405 otherwise). 2004 `scaled`
-  must be **-1..1** (error 407).
-- `setProgressMeasure` is a no-op in SCORM 1.2.
-- `setSessionTime(ms)` takes **milliseconds**; it formats per version internally.
-- `recordInteraction(index, record)` — index is the FIRST argument.
-- `addLearnerComment(comment, location?, timestamp?)` — location before timestamp.
-- SSR (Next.js/Remix): the core is SSR-safe; import `/wc` on the client only.
-
-## ScormError fields
-
-`code`, `errorString`, `operation`, `path`, `diagnostic`, `version`, `apiFound`, `initialized`.