scorm-skills

AI agent instructions that teach coding assistants how to use @studiolxd/scorm — a headless SCORM 1.2 / 2004 runtime for React, Vue, Angular, Svelte, Web Components, and vanilla JS.

One canonical source → many tool formats. Edit only source/skill.md; everything else is generated by node scripts/build.mjs.

Install per tool

Claude Code

Add this repo as a plugin marketplace, then install the skill:

/plugin marketplace add studiolxd/scorm-skills
/plugin install scorm-skills@studiolxd-scorm

Cursor

Copy the rule into your project:

cp cursor/scorm.mdc <your-project>/.cursor/rules/

Other agents (Antigravity, Copilot, generic)

Use the portable baseline agents/scorm.md — drop it into your project (e.g. append to AGENTS.md) or point your tool's rules at it.

Layout

source/skill.md                       # single source of truth (edit this)
scripts/build.mjs                     # generator: source → everything below
.claude-plugin/marketplace.json       # Claude Code marketplace (root = installable)
plugins/scorm-skills/            # the Claude Code plugin + skill
cursor/scorm.mdc          # Cursor rule
agents/scorm.md           # portable baseline

Regenerate after editing the source:

node scripts/build.mjs

What the skill covers

Choosing the right entry point/adapter, the lifecycle (initialize → commit → terminate), Result error handling (.ok before .value), SCORM 1.2 vs 2004 differences, mock mode, and the common gotchas (write-only 1.2 interactions, 0–100 score range, terminated-session rule, SSR safety).

Marketplace/plugin manifest schemas evolve — if /plugin marketplace add rejects the manifest, check it against the current Claude Code plugin docs.

Privacy

This plugin is static instruction text — it collects no data and makes no network requests. See PRIVACY.md.

License

MIT