Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,11 @@ The site of the [missing-elements](https://github.com/missing-elements) web comp
| `/pdfjs-viewer/` | The docs of `<pdfjs-viewer-element>`, 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.

Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
10 changes: 5 additions & 5 deletions pnpm-lock.yaml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion src/_includes/site-foot.njk
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@
<h2>Guides</h2>
<ul role="list">
<li><a href="/h5p/create-with-ai/">Create H5P content with AI</a></li>
<li><a href="/h5p/create-with-ai/#install">Install the h5p-author skill</a></li>
<li><a href="/h5p/create-with-ai/#install">Give your chat the h5p-author skill</a></li>
</ul>
</div>
<div>
Expand Down
8 changes: 4 additions & 4 deletions src/h5p/build/index.njk
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
<li class="feature">
<span class="feature-icon icon-ai" aria-hidden="true"></span>
<h3>Works with your AI chat</h3>
<p>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.</p>
<p>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.</p>
</li>
<li class="feature">
<span class="feature-icon icon-browser" aria-hidden="true"></span>
Expand Down Expand Up @@ -132,16 +132,16 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
</header>
<ol class="how" role="list">
<li>
<h3>Install the skill, once</h3>
<p>The h5p-author skill is the instructions that tell a chat how to write H5P. Download it and upload it to your chat: <a href="/h5p/create-with-ai/#install">where it goes in Claude, ChatGPT and Grok</a>.</p>
<h3>Give your chat the skill</h3>
<p>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: <a href="/h5p/create-with-ai/#install">where it goes in each</a>.</p>
</li>
<li>
<h3>Ask your chat</h3>
<p>Paste the prompt below into a new chat, with a subject of your own. The chat asks whose name and which licence go on the activity, which you may skip, and writes it.</p>
</li>
<li>
<h3>Play it, then download it</h3>
<p>Claude and Grok build the <code>.h5p</code> file in the chat, and so does ChatGPT with <a href="/h5p/create-with-ai/#install">the build archive</a>, kept in a Project or attached. Without it, ChatGPT hands over a link that opens the activity here, or its source, to <a href="#build-it">open or paste below</a>.</p>
<p>Claude and Grok build the <code>.h5p</code> file in the chat, and so does ChatGPT with <a href="/h5p/create-with-ai/#install">the build archive</a>, kept in a Project or attached. Without it, ChatGPT hands over the activity's source, to <a href="#build-it">open or paste below</a>.</p>
</li>
</ol>
<div class="prompt-box">
Expand Down
52 changes: 23 additions & 29 deletions src/h5p/create-with-ai/index.njk
Original file line number Diff line number Diff line change
Expand Up @@ -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" }
Expand All @@ -34,11 +34,12 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
<p class="lead">
An AI chat can write a whole H5P activity, not only its questions: a quiz, flash cards, a
course presentation or any of <a href="#types">{{ skill.offered.length }} H5P types</a>. Here
is how, from installing the skill to the <code>.h5p</code> file in your Moodle.
is how, from giving your chat the skill to the <code>.h5p</code> file in your Moodle.
</p>
<p>
The chat needs the h5p-author skill, the instructions that tell it how to write H5P: you
<a href="#install">install it once</a>. Then the chat writes the activity. Claude and Grok
<a href="#install">give it to your chat</a>, once in Claude and ChatGPT, and with your
message in Grok. Then the chat writes the activity. Claude and Grok
make it a <code>.h5p</code> file for Moodle or any other H5P site in the chat, and for
ChatGPT <a href="/h5p/build/">the build page</a> makes the file in your browser. The skill
and the page are free and <a href="#open-source">open source</a>, with no account.
Expand All @@ -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. -#}
<section class="step" aria-labelledby="install">
<h2 id="install"><span class="step-marker"><span class="step-number">1</span></span> Install the skill, once</h2>
<h2 id="install"><span class="step-marker"><span class="step-number">1</span></span> Give your chat the skill</h2>
<p>
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:
</p>
<ul>
<li>
Expand All @@ -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 <code>.h5p</code> 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.
</li>
<li>
<strong>Grok</strong>: download
<a href="/h5p/skill/h5p-author.zip" download>h5p-author.zip</a>, the same file as for
Claude, and upload it under Skills, then Import. Grok builds the <code>.h5p</code> file in
the chat.
</li>
<li>
<strong>Open WebUI</strong>: an administrator imports the skill under Import from URL, from
its folder on GitHub,
<code>https://github.com/missing-elements/h5p-offline-player/tree/main/skills/h5p-author</code>.
Claude, and attach it to the message where you ask, in each new chat. Grok builds the
<code>.h5p</code> file in the chat.
</li>
<li>
<strong>An agent with a terminal</strong>, such as Claude Code, Codex or Cursor:
Expand Down Expand Up @@ -128,12 +125,12 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
</p>
<ul>
<li>the <code>.h5p</code> 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;</li>
<li>a link that opens the activity on the build page, as ChatGPT gives without it;</li>
<li>or its source, as a file or a block of JSON: open or paste it <a href="/h5p/build/#build-it">on the build page</a> and choose Build.</li>
<li>or its source, as a file or a block of JSON, as ChatGPT gives without the archive: open or paste it <a href="/h5p/build/#build-it">on the build page</a> and choose Build.</li>
</ul>
<p>
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.
</p>
</section>

Expand Down Expand Up @@ -262,14 +259,11 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
does not run Node.js:
</p>
<ul>
<li>Open WebUI's code tool runs Python;</li>
<li>LM Studio's code plugin runs JavaScript in Deno, not Node.js;</li>
<li>Jan has no code tool of its own.</li>
</ul>
<p>
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.
</p>
<p>
With Node.js 22 or later on your own computer, the whole build can stay offline. Install the
Expand All @@ -286,8 +280,8 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
<h3>The chat doesn't use the skill</h3>
<p>
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 <a href="#install">step 1</a> put
it, and ask in a new chat.
knows no such skill, check that it is still where <a href="#install">step 1</a> put it, or
attached to your message in Grok, and ask in a new chat.
</p>

<h3>The chat says it cannot get the build tool</h3>
Expand All @@ -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.
</p>

<h3>The build lists problems</h3>
Expand Down
2 changes: 1 addition & 1 deletion src/h5p/skill/index.njk
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
app, from a zip:
</p>
<ul class="skill-files" role="list">
<li><a href="{{ base }}h5p-author.zip">{{ base }}h5p-author.zip</a>: for Claude and Grok</li>
<li><a href="{{ base }}h5p-author.zip">{{ base }}h5p-author.zip</a>: for Claude's Skills, and for Grok attached to a message</li>
<li><a href="{{ base }}h5p-author-chatgpt.zip">{{ base }}h5p-author-chatgpt.zip</a>: for ChatGPT's Plugins</li>
</ul>
</section>
Expand Down
12 changes: 8 additions & 4 deletions vite.config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -284,16 +284,20 @@ function tarGz(files: ReadonlyArray<readonly [string, Uint8Array]>): 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.
Expand Down
Loading