diff --git a/README.md b/README.md index 6b6e2ad..401980d 100644 --- a/README.md +++ b/README.md @@ -10,11 +10,11 @@ The site of the [missing-elements](https://github.com/missing-elements) web comp | `/pdfjs-viewer/` | The docs of ``, with a live preview | [src/pdfjs-viewer/](src/pdfjs-viewer/) | | `/h5p/build/` | The build page, for people: what it makes, a sample that plays, and the build of a chat's source into a `.h5p`, in the visitor's browser | [src/h5p/build/](src/h5p/build/) | | `/h5p/create-with-ai/` | The how-to, for people: installing the skill, asking a chat, the prompts to start from, the types, and what to do when something goes wrong | [src/h5p/create-with-ai/](src/h5p/create-with-ai/) | -| `/h5p/skill/` | The skill as zips to install: `h5p-author.zip` for Claude and Grok, `h5p-author-chatgpt.zip` for ChatGPT's Plugins; and a page that lists them and the bundles' addresses, each in full, which no page links to | [src/h5p/skill/](src/h5p/skill/); the zips written by [vite.config.ts](vite.config.ts) | +| `/h5p/skill/` | The skill as zips to install: `h5p-author.zip` for Claude's Skills and for Grok, attached to a message, `h5p-author-chatgpt.zip` for ChatGPT's Plugins; and a page that lists them and the bundles' addresses, each in full, which no page links to | [src/h5p/skill/](src/h5p/skill/); the zips written by [vite.config.ts](vite.config.ts) | | `/h5p/bundles/` | The skill's build tool and a library bundle per content type, for a chat that runs Node but cannot reach npm; and `h5p-author-build.tar.gz`, the tool and every library in one archive, for a person to attach to a chat whose code can download nothing | written by [vite.config.ts](vite.config.ts) | | `/h5p/build/types/` | The skill's type files, which the build page copies for the chat | written by [vite.config.ts](vite.config.ts) | -A chat takes the skill installed: from a zip in Claude, ChatGPT and Grok, or with `npx skills add` in an agent with a terminal, as `/h5p/create-with-ai/` says. Where the skill cannot reach npm, it builds from the tool and a bundle in `/h5p/bundles/`, at the addresses `/h5p/skill/` lists, if it can run Node and fetch a file: Grok did, on 2026-11-13. Where its code runs Node but can fetch nothing, as in ChatGPT, it builds from `h5p-author-build.tar.gz` once the person attaches it or keeps it in a ChatGPT Project (the owner's free account, 2026-11-14), and otherwise gives them a link to `/h5p/build/`, which builds in their browser. The tool is a Node.js program, so a chat whose code runs no Node, as most chat apps for local models, takes the link; an agent with a terminal and a local model builds offline from the archive. +A chat takes the skill installed: from a zip in Claude and ChatGPT, attached to a message in Grok, which has no place to install a skill, or with `npx skills add` in an agent with a terminal, as `/h5p/create-with-ai/` says. Where the skill cannot reach npm, it builds from the tool and a bundle in `/h5p/bundles/`, at the addresses `/h5p/skill/` lists, if it can run Node and fetch a file: Grok did, on 2026-11-13. Where its code runs Node but can fetch nothing, as in ChatGPT, it builds from `h5p-author-build.tar.gz` once the person attaches it or keeps it in a ChatGPT Project (the owner's free account, 2026-11-14), and otherwise hands them the source for `/h5p/build/`, which builds in their browser. The tool is a Node.js program, so a chat whose code runs no Node, as most chat apps for local models, hands over the source; an agent with a terminal and a local model builds offline from the archive. Until 2026-11-13 the site's prompts sent a chat to read the skill at `/h5p/skill/` instead. That worked only in chats that now take the zip, so the prompts name the installed skill, and no page links to `/h5p/skill/`. Its page stays, for the skill's route 3 and the copies already installed, which take the bundles' addresses from it. The skill's text files were served there one by one too until h5p-author 0.10.0: the zips carry them, so the site serves them only as zips. A copy of 0.9.7 or older, in a chat that has its text alone, and a prompt copied before 2026-11-13 find no files there now. diff --git a/package.json b/package.json index 273a0bd..9c6ec9b 100644 --- a/package.json +++ b/package.json @@ -28,7 +28,7 @@ "@codemirror/state": "6.7.6", "@codemirror/view": "6.43.15", "@lezer/highlight": "1.2.5", - "@missing-elements/h5p-author": "0.10.2", + "@missing-elements/h5p-author": "0.10.3", "@missing-elements/h5p-libraries": "1.1.0", "@missing-elements/h5p-offline-player": "1.6.0", "@missing-elements/h5p-runtime": "1.0.1", diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index 72c3f90..a309945 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -33,8 +33,8 @@ importers: specifier: 1.2.5 version: 1.2.5 '@missing-elements/h5p-author': - specifier: 0.10.2 - version: 0.10.2(@missing-elements/h5p-runtime@1.0.1) + specifier: 0.10.3 + version: 0.10.3(@missing-elements/h5p-runtime@1.0.1) '@missing-elements/h5p-libraries': specifier: 1.1.0 version: 1.1.0 @@ -155,8 +155,8 @@ packages: '@marijn/find-cluster-break@1.0.4': resolution: {integrity: sha512-Wy0V7+SGUjnF9/TkiM1hKVDPj7jKXduPNboMVtHTA8dySMURWqfg/JZ9E2Sq8JgSJmkl7k7Qe9FLeMSrSraWmQ==} - '@missing-elements/h5p-author@0.10.2': - resolution: {integrity: sha512-8lC7RtDwAfUahXeNenA/U1RbqTmZtIt2EV2SxkeDTqs3nGpYyyDjYOCGcwp1efVEgahsHL0mg8RO5H8mO7T7LQ==} + '@missing-elements/h5p-author@0.10.3': + resolution: {integrity: sha512-b9ukWOKRRjpgna+1mJEMS1Q0WCphX7ks7RonQXjgqmKbsT2RsUnTQAU0M4MF2YUXG7atWs9TJ1hsH0dYWGyzEQ==} engines: {node: '>=22'} hasBin: true @@ -1247,7 +1247,7 @@ snapshots: '@marijn/find-cluster-break@1.0.4': {} - '@missing-elements/h5p-author@0.10.2(@missing-elements/h5p-runtime@1.0.1)': + '@missing-elements/h5p-author@0.10.3(@missing-elements/h5p-runtime@1.0.1)': dependencies: '@missing-elements/h5p-libraries': 1.1.0 '@missing-elements/h5p-normalize': 1.3.0 diff --git a/src/_includes/site-foot.njk b/src/_includes/site-foot.njk index 7e879b3..e4eea7b 100644 --- a/src/_includes/site-foot.njk +++ b/src/_includes/site-foot.njk @@ -34,7 +34,7 @@

Guides

diff --git a/src/h5p/build/index.njk b/src/h5p/build/index.njk index 4fd722c..c4a92d4 100644 --- a/src/h5p/build/index.njk +++ b/src/h5p/build/index.njk @@ -98,7 +98,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
  • Works with your AI chat

    -

    Claude, ChatGPT and Grok take the h5p-author skill as a zip you upload once. An agent with a terminal, such as Claude Code, Codex or Cursor, installs it with one command.

    +

    Claude and ChatGPT take the h5p-author skill as a zip you upload once, and Grok reads Claude's zip attached to your message. An agent with a terminal, such as Claude Code, Codex or Cursor, installs it with one command.

  • @@ -132,8 +132,8 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
    1. -

      Install the skill, once

      -

      The h5p-author skill is the instructions that tell a chat how to write H5P. Download it and upload it to your chat: where it goes in Claude, ChatGPT and Grok.

      +

      Give your chat the skill

      +

      The h5p-author skill is the instructions that tell a chat how to write H5P. Download it and add it to your chat, once in Claude and ChatGPT and with your message in Grok: where it goes in each.

    2. Ask your chat

      @@ -141,7 +141,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
    3. Play it, then download it

      -

      Claude and Grok build the .h5p file in the chat, and so does ChatGPT with the build archive, kept in a Project or attached. Without it, ChatGPT hands over a link that opens the activity here, or its source, to open or paste below.

      +

      Claude and Grok build the .h5p file in the chat, and so does ChatGPT with the build archive, kept in a Project or attached. Without it, ChatGPT hands over the activity's source, to open or paste below.

    diff --git a/src/h5p/create-with-ai/index.njk b/src/h5p/create-with-ai/index.njk index c6a070b..916fd00 100644 --- a/src/h5p/create-with-ai/index.njk +++ b/src/h5p/create-with-ai/index.njk @@ -12,7 +12,7 @@ socialImage: alt: "The build page: its headline, Build an H5P activity with AI, and a course presentation playing beside it." # The top bar's links to the page's own sections (topbar.njk). topbarLinks: - - { href: "#install", text: "Install" } + - { href: "#install", text: "The skill" } - { href: "#prompts", text: "Prompts" } - { href: "#types", text: "Types" } - { href: "#open-source", text: "Open source" } @@ -34,11 +34,12 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o

    An AI chat can write a whole H5P activity, not only its questions: a quiz, flash cards, a course presentation or any of {{ skill.offered.length }} H5P types. Here - is how, from installing the skill to the .h5p file in your Moodle. + is how, from giving your chat the skill to the .h5p file in your Moodle.

    The chat needs the h5p-author skill, the instructions that tell it how to write H5P: you - install it once. Then the chat writes the activity. Claude and Grok + give it to your chat, once in Claude and ChatGPT, and with your + message in Grok. Then the chat writes the activity. Claude and Grok make it a .h5p file for Moodle or any other H5P site in the chat, and for ChatGPT the build page makes the file in your browser. The skill and the page are free and open source, with no account. @@ -48,14 +49,16 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o {#- The steps are drawn as the skill page's timeline (site.css). The first is the install: the zips are written by vite.config.ts from the release the site pins, and each was uploaded as - it is, by the owner, on 2026-11-13, Claude's into Grok too. The archive kept in a ChatGPT - Project built there on the owner's free account on 2026-11-14 (#49). Its heading keeps the - id that the top bar and the skill's page link to. -#} + it is, by the owner, on 2026-11-13. Grok has no place to install a skill, so it reads + Claude's zip attached (the owner, 2026-11-15). The archive + kept in a ChatGPT Project built there on the owner's free account on 2026-11-14 (#49). Its + heading keeps the id that the top bar and the skill's page link to. -#}

    -

    1 Install the skill, once

    +

    1 Give your chat the skill

    - The skill then stays in your chat, for every activity you ask for. Where it goes depends on - the chat: + Claude and ChatGPT install it once and keep it, for every activity you ask for. Grok has + nothing to install it into, and takes it with your message, in each new chat. Where it goes + depends on the chat:

    • @@ -71,19 +74,13 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o Make a Project in ChatGPT, add the archive to it, and ask in a chat of that project: ChatGPT then builds the .h5p file in the chat, with nothing to attach. Outside a project, attach the archive to the message where you ask. Without it, ChatGPT - hands over a link to the build page; if the page says the link arrived damaged, ask for - the source as a file and open that on the build page. + hands over the activity's source, to paste or open on the build page.
    • Grok: download h5p-author.zip, the same file as for - Claude, and upload it under Skills, then Import. Grok builds the .h5p file in - the chat. -
    • -
    • - Open WebUI: an administrator imports the skill under Import from URL, from - its folder on GitHub, - https://github.com/missing-elements/h5p-offline-player/tree/main/skills/h5p-author. + Claude, and attach it to the message where you ask, in each new chat. Grok builds the + .h5p file in the chat.
    • An agent with a terminal, such as Claude Code, Codex or Cursor: @@ -128,12 +125,12 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o

      • the .h5p file itself, from a chat whose code runs Node.js and can reach the build tool, as Claude's and Grok's can, and ChatGPT's with the build archive, kept in a Project or attached;
      • -
      • a link that opens the activity on the build page, as ChatGPT gives without it;
      • -
      • or its source, as a file or a block of JSON: open or paste it on the build page and choose Build.
      • +
      • or its source, as a file or a block of JSON, as ChatGPT gives without the archive: open or paste it on the build page and choose Build.

      - From a link or a source, the build page builds it in your browser, plays it, and saves the - file with Download the .h5p. + From the source, the build page builds it in your browser, plays it, and saves the file + with Download the .h5p. A chat that built the file gives its source file too: open it on the + build page to play the activity before you use it.

    @@ -262,14 +259,11 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o does not run Node.js:

      -
    • Open WebUI's code tool runs Python;
    • LM Studio's code plugin runs JavaScript in Deno, not Node.js;
    • Jan has no code tool of its own.

    - So there the chat hands over a link or the source, and the build page builds the file. Open - WebUI with Open Terminal is the exception: its default image has Node.js, which the build - needs. + So there the chat hands over the source, and the build page builds the file.

    With Node.js 22 or later on your own computer, the whole build can stay offline. Install the @@ -286,8 +280,8 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o

    The chat doesn't use the skill

    Name it in your message, as the prompts here do: "Use the h5p-author skill to…". If the chat - knows no such skill, check that it is still installed where step 1 put - it, and ask in a new chat. + knows no such skill, check that it is still where step 1 put it, or + attached to your message in Grok, and ask in a new chat.

    The chat says it cannot get the build tool

    @@ -296,7 +290,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o and attach it to your next message: a chat whose code runs Node.js builds the file from it, without installing or downloading anything. In ChatGPT, keep the archive in a Project and ask in a chat of it: there is then nothing to attach again. A chat whose code runs no - Node.js gives you a link to the build page instead. + Node.js gives you the activity's source for the build page instead.

    The build lists problems

    diff --git a/src/h5p/skill/index.njk b/src/h5p/skill/index.njk index fed4269..e38bcee 100644 --- a/src/h5p/skill/index.njk +++ b/src/h5p/skill/index.njk @@ -55,7 +55,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o app, from a zip:

    diff --git a/vite.config.ts b/vite.config.ts index c9ae14e..9d1c397 100644 --- a/vite.config.ts +++ b/vite.config.ts @@ -284,16 +284,20 @@ function tarGz(files: ReadonlyArray): Buffer { * are the only way the site serves the skill's text: every chat it is offered to installs it. * * - `h5p-author.zip`: the skill's folder at the zip's root, `h5p-author/SKILL.md`, which Claude's - * app takes under Customize, Skills, and Grok's under Skills, Import (as does Open WebUI's - * import). + * app takes under Customize, Skills. Grok has no place to install a skill (the owner, + * 2026-11-15): it reads this zip attached to a message. * - `h5p-author-chatgpt.zip`: the same files as a plugin, under `skills/h5p-author/`, with its * `plugin.json` at the root, which ChatGPT's Plugins take. A zip with the folder at its root is * refused there ("Plugin archive must contain … `skills/*\/SKILL.md`"). The manifest is the Agent * Plugins one, which allows no field but its own ten, with ChatGPT's name for the plugin under * `extensions`; a name that leads with "H5P" says who made it. * - * Both were uploaded as they are written here, by the owner on 2026-11-13, the first into Claude - * and into Grok. ChatGPT's code cannot read a plugin's files, so neither carries the build tool: + * Both were uploaded as they are written here, by the owner on 2026-11-13. One zip for every chat + * was tried on 2026-11-16 and is not possible: a zip holding both layouts is refused by Claude's + * Skills ("All files must be inside the top-level folder", "Zip must contain exactly one SKILL.md + * file. Currently there are 2"), though ChatGPT's Plugins took it; and the plugin layout alone + * would go into Claude under Plugins, which its free plan does not have, where Skills it has. + * ChatGPT's code cannot read a plugin's files, so neither carries the build tool: * where a chat's code cannot reach it, the person attaches `bundles()`'s archive, or the build page * builds. The plugin's description leads with what sets it apart, in the owner's words: privacy * first, no MCP server, so nothing a person makes passes through a server of ours.