Skip to content

Commit 637a7ae

Browse files
authored
Merge pull request #63 from missing-elements/feat/one-skill-zip
Grok takes the skill zip attached, and the guide stops promising a link
2 parents a1b4dd2 + 3df9e6e commit 637a7ae

8 files changed

Lines changed: 41 additions & 32 deletions

File tree

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,11 @@ The site of the [missing-elements](https://github.com/missing-elements) web comp
1010
| `/pdfjs-viewer/` | The docs of `<pdfjs-viewer-element>`, with a live preview | [src/pdfjs-viewer/](src/pdfjs-viewer/) |
1111
| `/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/) |
1212
| `/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/) |
13-
| `/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) |
13+
| `/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) |
1414
| `/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) |
1515
| `/h5p/build/types/` | The skill's type files, which the build page copies for the chat | written by [vite.config.ts](vite.config.ts) |
1616

17-
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.
17+
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.
1818

1919
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.
2020

‎package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@
2828
"@codemirror/state": "6.7.6",
2929
"@codemirror/view": "6.43.15",
3030
"@lezer/highlight": "1.2.5",
31-
"@missing-elements/h5p-author": "0.10.2",
31+
"@missing-elements/h5p-author": "0.10.3",
3232
"@missing-elements/h5p-libraries": "1.1.0",
3333
"@missing-elements/h5p-offline-player": "1.6.0",
3434
"@missing-elements/h5p-runtime": "1.0.1",

‎pnpm-lock.yaml‎

Lines changed: 5 additions & 5 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎src/_includes/site-foot.njk‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@
3434
<h2>Guides</h2>
3535
<ul role="list">
3636
<li><a href="/h5p/create-with-ai/">Create H5P content with AI</a></li>
37-
<li><a href="/h5p/create-with-ai/#install">Install the h5p-author skill</a></li>
37+
<li><a href="/h5p/create-with-ai/#install">Give your chat the h5p-author skill</a></li>
3838
</ul>
3939
</div>
4040
<div>

‎src/h5p/build/index.njk‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
9898
<li class="feature">
9999
<span class="feature-icon icon-ai" aria-hidden="true"></span>
100100
<h3>Works with your AI chat</h3>
101-
<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>
101+
<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>
102102
</li>
103103
<li class="feature">
104104
<span class="feature-icon icon-browser" aria-hidden="true"></span>
@@ -132,16 +132,16 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
132132
</header>
133133
<ol class="how" role="list">
134134
<li>
135-
<h3>Install the skill, once</h3>
136-
<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>
135+
<h3>Give your chat the skill</h3>
136+
<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>
137137
</li>
138138
<li>
139139
<h3>Ask your chat</h3>
140140
<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>
141141
</li>
142142
<li>
143143
<h3>Play it, then download it</h3>
144-
<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>
144+
<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>
145145
</li>
146146
</ol>
147147
<div class="prompt-box">

‎src/h5p/create-with-ai/index.njk‎

Lines changed: 19 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ socialImage:
1212
alt: "The build page: its headline, Build an H5P activity with AI, and a course presentation playing beside it."
1313
# The top bar's links to the page's own sections (topbar.njk).
1414
topbarLinks:
15-
- { href: "#install", text: "Install" }
15+
- { href: "#install", text: "The skill" }
1616
- { href: "#prompts", text: "Prompts" }
1717
- { href: "#types", text: "Types" }
1818
- { href: "#open-source", text: "Open source" }
@@ -34,11 +34,12 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
3434
<p class="lead">
3535
An AI chat can write a whole H5P activity, not only its questions: a quiz, flash cards, a
3636
course presentation or any of <a href="#types">{{ skill.offered.length }} H5P types</a>. Here
37-
is how, from installing the skill to the <code>.h5p</code> file in your Moodle.
37+
is how, from giving your chat the skill to the <code>.h5p</code> file in your Moodle.
3838
</p>
3939
<p>
4040
The chat needs the h5p-author skill, the instructions that tell it how to write H5P: you
41-
<a href="#install">install it once</a>. Then the chat writes the activity. Claude and Grok
41+
<a href="#install">give it to your chat</a>, once in Claude and ChatGPT, and with your
42+
message in Grok. Then the chat writes the activity. Claude and Grok
4243
make it a <code>.h5p</code> file for Moodle or any other H5P site in the chat, and for
4344
ChatGPT <a href="/h5p/build/">the build page</a> makes the file in your browser. The skill
4445
and the page are free and <a href="#open-source">open source</a>, with no account.
@@ -48,14 +49,16 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
4849

4950
{#- The steps are drawn as the skill page's timeline (site.css). The first is the install: the
5051
zips are written by vite.config.ts from the release the site pins, and each was uploaded as
51-
it is, by the owner, on 2026-11-13, Claude's into Grok too. The archive kept in a ChatGPT
52-
Project built there on the owner's free account on 2026-11-14 (#49). Its heading keeps the
53-
id that the top bar and the skill's page link to. -#}
52+
it is, by the owner, on 2026-11-13. Grok has no place to install a skill, so it reads
53+
Claude's zip attached (the owner, 2026-11-15). The archive
54+
kept in a ChatGPT Project built there on the owner's free account on 2026-11-14 (#49). Its
55+
heading keeps the id that the top bar and the skill's page link to. -#}
5456
<section class="step" aria-labelledby="install">
55-
<h2 id="install"><span class="step-marker"><span class="step-number">1</span></span> Install the skill, once</h2>
57+
<h2 id="install"><span class="step-marker"><span class="step-number">1</span></span> Give your chat the skill</h2>
5658
<p>
57-
The skill then stays in your chat, for every activity you ask for. Where it goes depends on
58-
the chat:
59+
Claude and ChatGPT install it once and keep it, for every activity you ask for. Grok has
60+
nothing to install it into, and takes it with your message, in each new chat. Where it goes
61+
depends on the chat:
5962
</p>
6063
<ul>
6164
<li>
@@ -76,8 +79,8 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
7679
<li>
7780
<strong>Grok</strong>: download
7881
<a href="/h5p/skill/h5p-author.zip" download>h5p-author.zip</a>, the same file as for
79-
Claude, and upload it under Skills, then Import. Grok builds the <code>.h5p</code> file in
80-
the chat.
82+
Claude, and attach it to the message where you ask, in each new chat. Grok builds the
83+
<code>.h5p</code> file in the chat.
8184
</li>
8285
<li>
8386
<strong>An agent with a terminal</strong>, such as Claude Code, Codex or Cursor:
@@ -125,8 +128,9 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
125128
<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>
126129
</ul>
127130
<p>
128-
From a link or a source, the build page builds it in your browser, plays it, and saves the
129-
file with Download the .h5p.
131+
From the source, the build page builds it in your browser, plays it, and saves the file
132+
with Download the .h5p. A chat that built the file gives its source file too: open it on the
133+
build page to play the activity before you use it.
130134
</p>
131135
</section>
132136

@@ -276,8 +280,8 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
276280
<h3>The chat doesn't use the skill</h3>
277281
<p>
278282
Name it in your message, as the prompts here do: "Use the h5p-author skill to…". If the chat
279-
knows no such skill, check that it is still installed where <a href="#install">step 1</a> put
280-
it, and ask in a new chat.
283+
knows no such skill, check that it is still where <a href="#install">step 1</a> put it, or
284+
attached to your message in Grok, and ask in a new chat.
281285
</p>
282286

283287
<h3>The chat says it cannot get the build tool</h3>

‎src/h5p/skill/index.njk‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
5555
app, from a zip:
5656
</p>
5757
<ul class="skill-files" role="list">
58-
<li><a href="{{ base }}h5p-author.zip">{{ base }}h5p-author.zip</a>: for Claude and Grok</li>
58+
<li><a href="{{ base }}h5p-author.zip">{{ base }}h5p-author.zip</a>: for Claude's Skills, and for Grok attached to a message</li>
5959
<li><a href="{{ base }}h5p-author-chatgpt.zip">{{ base }}h5p-author-chatgpt.zip</a>: for ChatGPT's Plugins</li>
6060
</ul>
6161
</section>

‎vite.config.ts‎

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -284,15 +284,20 @@ function tarGz(files: ReadonlyArray<readonly [string, Uint8Array]>): Buffer {
284284
* are the only way the site serves the skill's text: every chat it is offered to installs it.
285285
*
286286
* - `h5p-author.zip`: the skill's folder at the zip's root, `h5p-author/SKILL.md`, which Claude's
287-
* app takes under Customize, Skills, and Grok's under Skills, Import.
287+
* app takes under Customize, Skills. Grok has no place to install a skill (the owner,
288+
* 2026-11-15): it reads this zip attached to a message.
288289
* - `h5p-author-chatgpt.zip`: the same files as a plugin, under `skills/h5p-author/`, with its
289290
* `plugin.json` at the root, which ChatGPT's Plugins take. A zip with the folder at its root is
290291
* refused there ("Plugin archive must contain … `skills/*\/SKILL.md`"). The manifest is the Agent
291292
* Plugins one, which allows no field but its own ten, with ChatGPT's name for the plugin under
292293
* `extensions`; a name that leads with "H5P" says who made it.
293294
*
294-
* Both were uploaded as they are written here, by the owner on 2026-11-13, the first into Claude
295-
* and into Grok. ChatGPT's code cannot read a plugin's files, so neither carries the build tool:
295+
* Both were uploaded as they are written here, by the owner on 2026-11-13. One zip for every chat
296+
* was tried on 2026-11-16 and is not possible: a zip holding both layouts is refused by Claude's
297+
* Skills ("All files must be inside the top-level folder", "Zip must contain exactly one SKILL.md
298+
* file. Currently there are 2"), though ChatGPT's Plugins took it; and the plugin layout alone
299+
* would go into Claude under Plugins, which its free plan does not have, where Skills it has.
300+
* ChatGPT's code cannot read a plugin's files, so neither carries the build tool:
296301
* where a chat's code cannot reach it, the person attaches `bundles()`'s archive, or the build page
297302
* builds. The plugin's description leads with what sets it apart, in the owner's words: privacy
298303
* first, no MCP server, so nothing a person makes passes through a server of ours.

0 commit comments

Comments
 (0)