From d02aad4404795a2fa748734630432ed14bd2178d Mon Sep 17 00:00:00 2001
From: Aleksandr Shevchuk
Date: Sun, 15 Nov 2026 17:12:47 +0200
Subject: [PATCH 1/7] Create with AI: drop Open WebUI, which does not work with
the skill
Step 1 offered an install by Import from URL, and the local-model section named Open WebUI with
Open Terminal as a chat that builds the file. The owner found it does not work. The section's
remaining sentence says the chat hands over the source, as h5p-author 0.10.2 does.
Closes #59
---
src/h5p/create-with-ai/index.njk | 10 +---------
vite.config.ts | 3 +--
2 files changed, 2 insertions(+), 11 deletions(-)
diff --git a/src/h5p/create-with-ai/index.njk b/src/h5p/create-with-ai/index.njk
index c6a070b..c59ff83 100644
--- a/src/h5p/create-with-ai/index.njk
+++ b/src/h5p/create-with-ai/index.njk
@@ -80,11 +80,6 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
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.
-
An agent with a terminal, such as Claude Code, Codex or Cursor:
npx skills add missing-elements/h5p-offline-player --skill h5p-author.
@@ -262,14 +257,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
diff --git a/vite.config.ts b/vite.config.ts
index c9ae14e..4298a55 100644
--- a/vite.config.ts
+++ b/vite.config.ts
@@ -284,8 +284,7 @@ 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, and Grok's under Skills, Import.
* - `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
From 1edeb659d93b0747e88b5a5e51ca58d9f2024b89 Mon Sep 17 00:00:00 2001
From: Aleksandr Shevchuk
Date: Sun, 15 Nov 2026 17:36:22 +0200
Subject: [PATCH 2/7] Create with AI: a chat that builds nothing hands over the
source, not a link
Since h5p-author 0.10.2 no link carries the source. The ChatGPT item, step 4's list and the
troubleshooting entry still promised one (cubic's review on #60).
Refs #59
---
src/h5p/create-with-ai/index.njk | 8 +++-----
1 file changed, 3 insertions(+), 5 deletions(-)
diff --git a/src/h5p/create-with-ai/index.njk b/src/h5p/create-with-ai/index.njk
index c59ff83..2ca756e 100644
--- a/src/h5p/create-with-ai/index.njk
+++ b/src/h5p/create-with-ai/index.njk
@@ -71,8 +71,7 @@ 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
@@ -123,8 +122,7 @@ 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
@@ -288,7 +286,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
From caa10b0e562138b778c572faa29d8a706e2f456d Mon Sep 17 00:00:00 2001
From: Aleksandr Shevchuk
Date: Mon, 16 Nov 2026 09:57:25 +0200
Subject: [PATCH 3/7] One skill zip for every chat app, and Grok takes it
attached
h5p-author.zip now holds the skill as a plugin (plugin.json and skills/h5p-author/, which
ChatGPT's Plugins take) and as the skill's folder at the root (h5p-author/, which Claude's
Skills take); h5p-author-chatgpt.zip goes. Grok has no place to install a skill, so the
guide says to attach the zip to the message. The build page, the skill page, the README
and the comments name one zip.
Closes #62
---
README.md | 8 ++--
src/_data/skill.js | 2 +-
src/h5p/build/index.njk | 6 +--
src/h5p/create-with-ai/index.njk | 21 +++++------
src/h5p/skill/index.njk | 15 ++++----
vite.config.ts | 63 +++++++++++++++++---------------
6 files changed, 59 insertions(+), 56 deletions(-)
diff --git a/README.md b/README.md
index 6b6e2ad..baefcfa 100644
--- a/README.md
+++ b/README.md
@@ -10,13 +10,13 @@ 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 one zip to install, `h5p-author.zip`, for Claude's Skills and ChatGPT's Plugins, and for Grok attached to a message; and a page that lists it and the bundles' addresses, each in full, which no page links to | [src/h5p/skill/](src/h5p/skill/); the zip 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 one 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, and does again from h5p-author 0.10.3. 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.
+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 zip carries them, so the site serves them only as a zip. 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.
## Develop
@@ -44,7 +44,7 @@ The pages run published releases, pinned exactly in [package.json](package.json)
| Package | What it moves |
| --- | --- |
| `@missing-elements/pdfjs-viewer` | The docs' version numbers, and the viewer in the live preview |
-| `@missing-elements/h5p-author` | The build the build page runs, its sample, the type files, the skill's zips at `/h5p/skill/`, and the tool in `/h5p/bundles/` |
+| `@missing-elements/h5p-author` | The build the build page runs, its sample, the type files, the skill's zip at `/h5p/skill/`, and the tool in `/h5p/bundles/` |
| `@missing-elements/h5p-libraries` | The library pack: the build page's libraries, and the bundles |
| `@missing-elements/h5p-offline-player`, `@missing-elements/h5p-runtime` | The player on the build page, and its runtime |
diff --git a/src/_data/skill.js b/src/_data/skill.js
index 0dcf10f..a3873cc 100644
--- a/src/_data/skill.js
+++ b/src/_data/skill.js
@@ -2,7 +2,7 @@ import { existsSync, readFileSync } from "node:fs";
import { contentTypes, openPack } from "@missing-elements/h5p-author";
// The h5p-author skill as the pinned @missing-elements/h5p-author carries it since 0.9.0. The site
-// serves it only as the zips vite.config.ts writes to /h5p/skill/: its text files are not served
+// serves it only as the zip vite.config.ts writes to /h5p/skill/: its text files are not served
// one by one, since every chat it is offered to installs it (README.md).
const author = "node_modules/@missing-elements/h5p-author";
const { version } = JSON.parse(readFileSync(`${author}/package.json`, "utf8"));
diff --git a/src/h5p/build/index.njk b/src/h5p/build/index.njk
index 4fd722c..915a41b 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 the same zip attached to your message. An agent with a terminal, such as Claude Code, Codex or Cursor, installs it with one command.
@@ -133,7 +133,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
-
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.
+ The h5p-author skill is the instructions that tell a chat how to write H5P. Download it and add it to your chat: where it goes in Claude, ChatGPT and Grok.
-
Ask your chat
@@ -141,7 +141,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
-
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 2ca756e..01d8404 100644
--- a/src/h5p/create-with-ai/index.njk
+++ b/src/h5p/create-with-ai/index.njk
@@ -46,11 +46,11 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
Open the build page
- {#- 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. -#}
+ {#- The steps are drawn as the skill page's timeline (site.css). The first is the install: one
+ zip for every chat, written by vite.config.ts from the release the site pins. Grok has no
+ place to install a skill, so it reads the 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
@@ -65,7 +65,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
ChatGPT: download
- h5p-author-chatgpt.zip and upload it
+ h5p-author.zip, the same file, and upload it
under Plugins. ChatGPT's code cannot download the build tool, so download
h5p-author-build.tar.gz once too.
Make a Project in ChatGPT, add the archive to it, and ask in a chat of that project:
@@ -74,10 +74,9 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
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.
+ Grok has no place to install a skill: download
+ h5p-author.zip, the same file, and attach it
+ to the message where you ask. Grok builds the .h5p file in the chat.
An agent with a terminal, such as Claude Code, Codex or Cursor:
@@ -85,7 +84,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
- The zips hold h5p-author {{ skill.version }}, the release the build page runs: text files and
+ The zip holds h5p-author {{ skill.version }}, the release the build page runs: text files and
nothing that runs, which you can read
on GitHub.
The archive holds the same release's build tool, which runs in the chat's own sandbox, and
diff --git a/src/h5p/skill/index.njk b/src/h5p/skill/index.njk
index fed4269..ac47d41 100644
--- a/src/h5p/skill/index.njk
+++ b/src/h5p/skill/index.njk
@@ -1,7 +1,7 @@
---
layout: base.njk
title: The h5p-author skill · Missing Elements
-description: The h5p-author skill's zips to install, and the files its build fetches where npm cannot be reached, each at its full address.
+description: The h5p-author skill's zip to install, and the files its build fetches where npm cannot be reached, each at its full address.
# No script but the site's: base.njk writes the policy first in
, and the color-scheme script
# is added to script-src by its hash at build (eleventy.config.js).
csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; object-src 'none'; base-uri 'self'"
@@ -10,8 +10,8 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
the skill from this page: the skill is installed, which is the guide's first step. The page
stays for what names its address: the skill's route 3, and the copies of it already installed,
which take the build tool's and the bundles' addresses from it where npm cannot be reached (as
- Grok built on 2026-11-13). The zips are served from this folder too. Its text files are not:
- the zips carry them, and a chat with the text alone, which read them here until 0.9.7, is one
+ Grok built on 2026-11-13). The zip is served from this folder too. Its text files are not:
+ the zip carries them, and a chat with the text alone, which read them here until 0.9.7, is one
the skill is no longer offered to (the owner, 2026-11-15). -#}
{#- Every address is written out whole, as its link's text too: a chat's fetch tool may open only
the addresses it has seen in full, and a relative link is none. -#}
@@ -23,7 +23,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
@@ -52,11 +52,10 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
In an agent with a terminal:
npx skills add missing-elements/h5p-offline-player --skill h5p-author. In a chat
- app, from a zip:
+ app, from one zip:
diff --git a/vite.config.ts b/vite.config.ts
index 4298a55..eaa2939 100644
--- a/vite.config.ts
+++ b/vite.config.ts
@@ -21,10 +21,10 @@ import { build, defineConfig, type Plugin } from 'vite'
* - `/h5p/build/sample.h5p` and `sample.json`, the sample the page plays where it is opened with no
* source, and its source (see `sample()`).
* - `/h5p/bundles/`, for a chat that reaches no npm registry (see `bundles()`).
- * - `/h5p/skill/h5p-author.zip` and `h5p-author-chatgpt.zip`, the h5p-author skill to install (see
+ * - `/h5p/skill/h5p-author.zip`, the h5p-author skill to install, one file for every chat (see
* `skillZips()`).
*
- * `/h5p/skill/`'s page, which lists the zips and the bundles' addresses, is Eleventy's
+ * `/h5p/skill/`'s page, which lists the zip and the bundles' addresses, is Eleventy's
* (`src/h5p/skill/`). It is written before the bundles: it names them from the author package's
* `contentTypes`, the list `writeBundles` writes from.
*
@@ -280,22 +280,25 @@ function tarGz(files: ReadonlyArray
): Buffer {
}
/**
- * The h5p-author skill as zips to install, in `/h5p/skill/`, from the pinned author package. They
- * are the only way the site serves the skill's text: every chat it is offered to installs it.
+ * The h5p-author skill as one zip to install, `/h5p/skill/h5p-author.zip`, from the pinned author
+ * package: the only way the site serves the skill's text, since every chat it is offered to
+ * installs it. One file for every chat (the owner, 2026-11-15), so it holds the skill twice:
*
- * - `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.
- * - `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.
+ * - as a plugin, which ChatGPT's Plugins take: `plugin.json` at the root and the skill under
+ * `skills/h5p-author/`. A zip with only 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.
+ * - as the skill's folder at the root, `h5p-author/SKILL.md`, which Claude's app takes under
+ * Customize, Skills: it looks for `/SKILL.md`.
*
- * 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:
- * 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.
+ * Grok has no place to install a skill (the owner, 2026-11-15): the person attaches the zip to the
+ * message, and Grok reads the skill from it. Until then the site served two zips, the folder alone
+ * for Claude and Grok and the plugin for ChatGPT, each uploaded as written by the owner on
+ * 2026-11-13. ChatGPT's code cannot read a plugin's files, so the zip carries no 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.
*/
function skillZips(): Plugin {
const author = new URL('./node_modules/@missing-elements/h5p-author/', import.meta.url)
@@ -338,29 +341,31 @@ function skillZips(): Plugin {
}
const folder = join(outDir, 'h5p', 'skill')
await mkdir(folder, { recursive: true })
- await writeFile(join(folder, 'h5p-author.zip'), await zipOf('h5p-author/', skill))
- await writeFile(join(folder, 'h5p-author-chatgpt.zip'), await zipOf('skills/h5p-author/', skill, [['plugin.json', new TextEncoder().encode(`${JSON.stringify(manifest, null, 2)}\n`)]]))
+ const plugin = new TextEncoder().encode(`${JSON.stringify(manifest, null, 2)}\n`)
+ await writeFile(join(folder, 'h5p-author.zip'), await zipOf(['skills/h5p-author/', 'h5p-author/'], skill, [['plugin.json', plugin]]))
}
}
}
/**
- * A zip of the files under `prefix`, after the files at its root, with an entry for each folder
- * before what is in it, as `git archive` writes one: the shape of the zips first uploaded.
+ * A zip of the files under each of `prefixes`, after the files at its root, with an entry for each
+ * folder before what is in it, as `git archive` writes one: the shape of the zips first uploaded.
*/
-async function zipOf(prefix: string, files: ReadonlyArray, atRoot: ReadonlyArray = []): Promise {
+async function zipOf(prefixes: readonly string[], files: ReadonlyArray, atRoot: ReadonlyArray = []): Promise {
const writer = new ZipWriter(new Uint8ArrayWriter(), { useWebWorkers: false, lastModDate: ZIP_DATE, extendedTimestamp: false })
for (const [path, bytes] of atRoot) await writer.add(path, new Uint8ArrayReader(bytes))
const folders = new Set()
- for (const [path, bytes] of files) {
- const parts = `${prefix}${path}`.split('/')
- for (let depth = 1; depth < parts.length; depth++) {
- const name = `${parts.slice(0, depth).join('/')}/`
- if (folders.has(name)) continue
- folders.add(name)
- await writer.add(name, undefined, { directory: true })
+ for (const prefix of prefixes) {
+ for (const [path, bytes] of files) {
+ const parts = `${prefix}${path}`.split('/')
+ for (let depth = 1; depth < parts.length; depth++) {
+ const name = `${parts.slice(0, depth).join('/')}/`
+ if (folders.has(name)) continue
+ folders.add(name)
+ await writer.add(name, undefined, { directory: true })
+ }
+ await writer.add(`${prefix}${path}`, new Uint8ArrayReader(bytes))
}
- await writer.add(`${prefix}${path}`, new Uint8ArrayReader(bytes))
}
return writer.close()
}
From fbcbe0a786333ca898c849f633ee614c252dcce0 Mon Sep 17 00:00:00 2001
From: Aleksandr Shevchuk
Date: Mon, 16 Nov 2026 10:04:45 +0200
Subject: [PATCH 4/7] Create with AI: Grok takes the zip in each new chat; the
README claims no Grok build not yet seen
The install step said the skill then stays in the chat, which holds for Claude and ChatGPT
only. The README said Grok builds again from h5p-author 0.10.3, which no one has seen yet.
Refs #62
---
README.md | 2 +-
src/h5p/create-with-ai/index.njk | 7 ++++---
2 files changed, 5 insertions(+), 4 deletions(-)
diff --git a/README.md b/README.md
index baefcfa..3b2004a 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,7 @@ The site of the [missing-elements](https://github.com/missing-elements) web comp
| `/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 one 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, and does again from h5p-author 0.10.3. 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.
+A chat takes the skill installed: from one 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 zip carries them, so the site serves them only as a zip. 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/src/h5p/create-with-ai/index.njk b/src/h5p/create-with-ai/index.njk
index 01d8404..2fcfef5 100644
--- a/src/h5p/create-with-ai/index.njk
+++ b/src/h5p/create-with-ai/index.njk
@@ -54,8 +54,8 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
1 Install the skill, once
- The skill then stays in your chat, for every activity you ask for. Where it goes depends on
- the chat:
+ In Claude and ChatGPT the skill then stays, for every activity you ask for. Where it goes
+ depends on the chat:
-
@@ -76,7 +76,8 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
-
Grok has no place to install a skill: download
h5p-author.zip, the same file, and attach it
- to the message where you ask. Grok builds the
.h5p file in the chat.
+ 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:
From 57b4a1d03e5e78e62a125e07bb3c2c1305dd4949 Mon Sep 17 00:00:00 2001
From: Aleksandr Shevchuk
Date: Mon, 16 Nov 2026 11:31:24 +0200
Subject: [PATCH 5/7] Keep the two skill zips: Claude's Skills refuse a zip
that holds the skill twice
A zip with both layouts was uploaded on 2026-11-16: ChatGPT's Plugins took it, and Claude's
Skills refused it ("All files must be inside the top-level folder", "Zip must contain exactly
one SKILL.md file. Currently there are 2"). The plugin layout alone would go into Claude under
Plugins, which its free plan does not have. So h5p-author.zip and h5p-author-chatgpt.zip stay
as they were, and Grok, which has no place to install a skill, takes Claude's zip attached, in
each new chat. Step 4 no longer says a chat hands over a link.
Refs #62
---
README.md | 8 ++--
src/_data/skill.js | 2 +-
src/h5p/build/index.njk | 2 +-
src/h5p/create-with-ai/index.njk | 20 +++++-----
src/h5p/skill/index.njk | 15 +++----
vite.config.ts | 68 ++++++++++++++++----------------
6 files changed, 59 insertions(+), 56 deletions(-)
diff --git a/README.md b/README.md
index 3b2004a..401980d 100644
--- a/README.md
+++ b/README.md
@@ -10,13 +10,13 @@ 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 one zip to install, `h5p-author.zip`, for Claude's Skills and ChatGPT's Plugins, and for Grok attached to a message; and a page that lists it and the bundles' addresses, each in full, which no page links to | [src/h5p/skill/](src/h5p/skill/); the zip 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 one 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.
+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 zip carries them, so the site serves them only as a zip. 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.
+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.
## Develop
@@ -44,7 +44,7 @@ The pages run published releases, pinned exactly in [package.json](package.json)
| Package | What it moves |
| --- | --- |
| `@missing-elements/pdfjs-viewer` | The docs' version numbers, and the viewer in the live preview |
-| `@missing-elements/h5p-author` | The build the build page runs, its sample, the type files, the skill's zip at `/h5p/skill/`, and the tool in `/h5p/bundles/` |
+| `@missing-elements/h5p-author` | The build the build page runs, its sample, the type files, the skill's zips at `/h5p/skill/`, and the tool in `/h5p/bundles/` |
| `@missing-elements/h5p-libraries` | The library pack: the build page's libraries, and the bundles |
| `@missing-elements/h5p-offline-player`, `@missing-elements/h5p-runtime` | The player on the build page, and its runtime |
diff --git a/src/_data/skill.js b/src/_data/skill.js
index a3873cc..0dcf10f 100644
--- a/src/_data/skill.js
+++ b/src/_data/skill.js
@@ -2,7 +2,7 @@ import { existsSync, readFileSync } from "node:fs";
import { contentTypes, openPack } from "@missing-elements/h5p-author";
// The h5p-author skill as the pinned @missing-elements/h5p-author carries it since 0.9.0. The site
-// serves it only as the zip vite.config.ts writes to /h5p/skill/: its text files are not served
+// serves it only as the zips vite.config.ts writes to /h5p/skill/: its text files are not served
// one by one, since every chat it is offered to installs it (README.md).
const author = "node_modules/@missing-elements/h5p-author";
const { version } = JSON.parse(readFileSync(`${author}/package.json`, "utf8"));
diff --git a/src/h5p/build/index.njk b/src/h5p/build/index.njk
index 915a41b..134b0b3 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 and ChatGPT take the h5p-author skill as a zip you upload once, and Grok reads the same zip attached to your message. 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.
-
diff --git a/src/h5p/create-with-ai/index.njk b/src/h5p/create-with-ai/index.njk
index 2fcfef5..d1e743a 100644
--- a/src/h5p/create-with-ai/index.njk
+++ b/src/h5p/create-with-ai/index.njk
@@ -46,9 +46,10 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
Open the build page
- {#- The steps are drawn as the skill page's timeline (site.css). The first is the install: one
- zip for every chat, written by vite.config.ts from the release the site pins. Grok has no
- place to install a skill, so it reads the zip attached (the owner, 2026-11-15). The archive
+ {#- 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. 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. -#}
@@ -65,7 +66,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
-
ChatGPT: download
- h5p-author.zip, the same file, and upload it
+ h5p-author-chatgpt.zip and upload it
under Plugins. ChatGPT's code cannot download the build tool, so download
h5p-author-build.tar.gz once too.
Make a Project in ChatGPT, add the archive to it, and ask in a chat of that project:
@@ -75,8 +76,8 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
-
Grok has no place to install a skill: download
- h5p-author.zip, the same file, and attach it
- to the message where you ask, in each new chat. Grok builds the
.h5p file in
+ h5p-author.zip, the same file as for
+ Claude, and attach it to the message where you ask, in each new chat. Grok builds the .h5p file in
the chat.
-
@@ -85,7 +86,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
- The zip holds h5p-author {{ skill.version }}, the release the build page runs: text files and
+ The zips hold h5p-author {{ skill.version }}, the release the build page runs: text files and
nothing that runs, which you can read
on GitHub.
The archive holds the same release's build tool, which runs in the chat's own sandbox, and
@@ -125,8 +126,9 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
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.
diff --git a/src/h5p/skill/index.njk b/src/h5p/skill/index.njk
index ac47d41..e38bcee 100644
--- a/src/h5p/skill/index.njk
+++ b/src/h5p/skill/index.njk
@@ -1,7 +1,7 @@
---
layout: base.njk
title: The h5p-author skill · Missing Elements
-description: The h5p-author skill's zip to install, and the files its build fetches where npm cannot be reached, each at its full address.
+description: The h5p-author skill's zips to install, and the files its build fetches where npm cannot be reached, each at its full address.
# No script but the site's: base.njk writes the policy first in , and the color-scheme script
# is added to script-src by its hash at build (eleventy.config.js).
csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; object-src 'none'; base-uri 'self'"
@@ -10,8 +10,8 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
the skill from this page: the skill is installed, which is the guide's first step. The page
stays for what names its address: the skill's route 3, and the copies of it already installed,
which take the build tool's and the bundles' addresses from it where npm cannot be reached (as
- Grok built on 2026-11-13). The zip is served from this folder too. Its text files are not:
- the zip carries them, and a chat with the text alone, which read them here until 0.9.7, is one
+ Grok built on 2026-11-13). The zips are served from this folder too. Its text files are not:
+ the zips carry them, and a chat with the text alone, which read them here until 0.9.7, is one
the skill is no longer offered to (the owner, 2026-11-15). -#}
{#- Every address is written out whole, as its link's text too: a chat's fetch tool may open only
the addresses it has seen in full, and a relative link is none. -#}
@@ -23,7 +23,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
@@ -52,10 +52,11 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
In an agent with a terminal:
npx skills add missing-elements/h5p-offline-player --skill h5p-author. In a chat
- app, from one zip:
+ app, from a zip:
diff --git a/vite.config.ts b/vite.config.ts
index eaa2939..9d1c397 100644
--- a/vite.config.ts
+++ b/vite.config.ts
@@ -21,10 +21,10 @@ import { build, defineConfig, type Plugin } from 'vite'
* - `/h5p/build/sample.h5p` and `sample.json`, the sample the page plays where it is opened with no
* source, and its source (see `sample()`).
* - `/h5p/bundles/`, for a chat that reaches no npm registry (see `bundles()`).
- * - `/h5p/skill/h5p-author.zip`, the h5p-author skill to install, one file for every chat (see
+ * - `/h5p/skill/h5p-author.zip` and `h5p-author-chatgpt.zip`, the h5p-author skill to install (see
* `skillZips()`).
*
- * `/h5p/skill/`'s page, which lists the zip and the bundles' addresses, is Eleventy's
+ * `/h5p/skill/`'s page, which lists the zips and the bundles' addresses, is Eleventy's
* (`src/h5p/skill/`). It is written before the bundles: it names them from the author package's
* `contentTypes`, the list `writeBundles` writes from.
*
@@ -280,25 +280,27 @@ function tarGz(files: ReadonlyArray): Buffer {
}
/**
- * The h5p-author skill as one zip to install, `/h5p/skill/h5p-author.zip`, from the pinned author
- * package: the only way the site serves the skill's text, since every chat it is offered to
- * installs it. One file for every chat (the owner, 2026-11-15), so it holds the skill twice:
+ * The h5p-author skill as zips to install, in `/h5p/skill/`, from the pinned author package. They
+ * are the only way the site serves the skill's text: every chat it is offered to installs it.
*
- * - as a plugin, which ChatGPT's Plugins take: `plugin.json` at the root and the skill under
- * `skills/h5p-author/`. A zip with only 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.
- * - as the skill's folder at the root, `h5p-author/SKILL.md`, which Claude's app takes under
- * Customize, Skills: it looks for `/SKILL.md`.
+ * - `h5p-author.zip`: the skill's folder at the zip's root, `h5p-author/SKILL.md`, which Claude's
+ * 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.
*
- * Grok has no place to install a skill (the owner, 2026-11-15): the person attaches the zip to the
- * message, and Grok reads the skill from it. Until then the site served two zips, the folder alone
- * for Claude and Grok and the plugin for ChatGPT, each uploaded as written by the owner on
- * 2026-11-13. ChatGPT's code cannot read a plugin's files, so the zip carries no 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.
+ * 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.
*/
function skillZips(): Plugin {
const author = new URL('./node_modules/@missing-elements/h5p-author/', import.meta.url)
@@ -341,31 +343,29 @@ function skillZips(): Plugin {
}
const folder = join(outDir, 'h5p', 'skill')
await mkdir(folder, { recursive: true })
- const plugin = new TextEncoder().encode(`${JSON.stringify(manifest, null, 2)}\n`)
- await writeFile(join(folder, 'h5p-author.zip'), await zipOf(['skills/h5p-author/', 'h5p-author/'], skill, [['plugin.json', plugin]]))
+ await writeFile(join(folder, 'h5p-author.zip'), await zipOf('h5p-author/', skill))
+ await writeFile(join(folder, 'h5p-author-chatgpt.zip'), await zipOf('skills/h5p-author/', skill, [['plugin.json', new TextEncoder().encode(`${JSON.stringify(manifest, null, 2)}\n`)]]))
}
}
}
/**
- * A zip of the files under each of `prefixes`, after the files at its root, with an entry for each
- * folder before what is in it, as `git archive` writes one: the shape of the zips first uploaded.
+ * A zip of the files under `prefix`, after the files at its root, with an entry for each folder
+ * before what is in it, as `git archive` writes one: the shape of the zips first uploaded.
*/
-async function zipOf(prefixes: readonly string[], files: ReadonlyArray, atRoot: ReadonlyArray = []): Promise {
+async function zipOf(prefix: string, files: ReadonlyArray, atRoot: ReadonlyArray = []): Promise {
const writer = new ZipWriter(new Uint8ArrayWriter(), { useWebWorkers: false, lastModDate: ZIP_DATE, extendedTimestamp: false })
for (const [path, bytes] of atRoot) await writer.add(path, new Uint8ArrayReader(bytes))
const folders = new Set()
- for (const prefix of prefixes) {
- for (const [path, bytes] of files) {
- const parts = `${prefix}${path}`.split('/')
- for (let depth = 1; depth < parts.length; depth++) {
- const name = `${parts.slice(0, depth).join('/')}/`
- if (folders.has(name)) continue
- folders.add(name)
- await writer.add(name, undefined, { directory: true })
- }
- await writer.add(`${prefix}${path}`, new Uint8ArrayReader(bytes))
+ for (const [path, bytes] of files) {
+ const parts = `${prefix}${path}`.split('/')
+ for (let depth = 1; depth < parts.length; depth++) {
+ const name = `${parts.slice(0, depth).join('/')}/`
+ if (folders.has(name)) continue
+ folders.add(name)
+ await writer.add(name, undefined, { directory: true })
}
+ await writer.add(`${prefix}${path}`, new Uint8ArrayReader(bytes))
}
return writer.close()
}
From 9e60eab47f13ab5783874bf3972e10270329936c Mon Sep 17 00:00:00 2001
From: Aleksandr Shevchuk
Date: Mon, 16 Nov 2026 13:17:46 +0200
Subject: [PATCH 6/7] Pin h5p-author 0.10.3
The skill's zips, the build tool, the bundles and the build page's own build move to 0.10.3:
route 3 is tried wherever Node runs, so Grok builds in the chat with no archive, and a
package built in a chat comes with its source file and the build page's plain address.
Refs #62
---
package.json | 2 +-
pnpm-lock.yaml | 10 +++++-----
2 files changed, 6 insertions(+), 6 deletions(-)
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
From 3df9e6ef9c12ae225dcbf9cce3077f1af2222a65 Mon Sep 17 00:00:00 2001
From: Aleksandr Shevchuk
Date: Mon, 16 Nov 2026 13:25:37 +0200
Subject: [PATCH 7/7] Create with AI: the first step is giving the chat the
skill, which Grok takes with each message
The step was headed "Install the skill, once", which Grok cannot do (cubic's review on #63).
The guide's heading, its opening and the build page's step now say Claude and ChatGPT keep
the skill once installed, and Grok takes the zip with the message in each new chat. The
step keeps its id, install, which other pages link to.
Refs #62
---
src/_includes/site-foot.njk | 2 +-
src/h5p/build/index.njk | 4 ++--
src/h5p/create-with-ai/index.njk | 22 ++++++++++++----------
3 files changed, 15 insertions(+), 13 deletions(-)
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 134b0b3..c4a92d4 100644
--- a/src/h5p/build/index.njk
+++ b/src/h5p/build/index.njk
@@ -132,8 +132,8 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
-
-
Install the skill, once
- The h5p-author skill is the instructions that tell a chat how to write H5P. Download it and add 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.
-
Ask your chat
diff --git a/src/h5p/create-with-ai/index.njk b/src/h5p/create-with-ai/index.njk
index d1e743a..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.
@@ -53,9 +54,10 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
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
- In Claude and ChatGPT the skill then stays, for every activity you ask for. Where it goes
+ 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:
@@ -75,10 +77,10 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
hands over the activity's source, to paste or open on the build page.
-
- Grok has no place to install a skill: download
+ Grok: download
h5p-author.zip, the same file as for
- Claude, and attach it to the message where you ask, in each new chat. Grok builds the
.h5p file in
- the chat.
+ 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:
@@ -278,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