Skip to content

Commit caa10b0

Browse files
committed
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
1 parent 1edeb65 commit caa10b0

6 files changed

Lines changed: 59 additions & 56 deletions

File tree

‎README.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,13 @@ 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 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) |
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 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.
1818

19-
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.
19+
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.
2020

2121
## Develop
2222

@@ -44,7 +44,7 @@ The pages run published releases, pinned exactly in [package.json](package.json)
4444
| Package | What it moves |
4545
| --- | --- |
4646
| `@missing-elements/pdfjs-viewer` | The docs' version numbers, and the viewer in the live preview |
47-
| `@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/` |
47+
| `@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/` |
4848
| `@missing-elements/h5p-libraries` | The library pack: the build page's libraries, and the bundles |
4949
| `@missing-elements/h5p-offline-player`, `@missing-elements/h5p-runtime` | The player on the build page, and its runtime |
5050

‎src/_data/skill.js‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ import { existsSync, readFileSync } from "node:fs";
22
import { contentTypes, openPack } from "@missing-elements/h5p-author";
33

44
// The h5p-author skill as the pinned @missing-elements/h5p-author carries it since 0.9.0. The site
5-
// serves it only as the zips vite.config.ts writes to /h5p/skill/: its text files are not served
5+
// serves it only as the zip vite.config.ts writes to /h5p/skill/: its text files are not served
66
// one by one, since every chat it is offered to installs it (README.md).
77
const author = "node_modules/@missing-elements/h5p-author";
88
const { version } = JSON.parse(readFileSync(`${author}/package.json`, "utf8"));

‎src/h5p/build/index.njk‎

Lines changed: 3 additions & 3 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 the same 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>
@@ -133,15 +133,15 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
133133
<ol class="how" role="list">
134134
<li>
135135
<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>
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: <a href="/h5p/create-with-ai/#install">where it goes in Claude, ChatGPT and Grok</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: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -46,11 +46,11 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
4646
<p><a class="button button-solid button-large" href="/h5p/build/">Open the build page</a></p>
4747
</header>
4848

49-
{#- The steps are drawn as the skill page's timeline (site.css). The first is the install: the
50-
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. -#}
49+
{#- The steps are drawn as the skill page's timeline (site.css). The first is the install: one
50+
zip for every chat, written by vite.config.ts from the release the site pins. Grok has no
51+
place to install a skill, so it reads the zip attached (the owner, 2026-11-15). The archive
52+
kept in a ChatGPT Project built there on the owner's free account on 2026-11-14 (#49). Its
53+
heading keeps the id that the top bar and the skill's page link to. -#}
5454
<section class="step" aria-labelledby="install">
5555
<h2 id="install"><span class="step-marker"><span class="step-number">1</span></span> Install the skill, once</h2>
5656
<p>
@@ -65,7 +65,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
6565
</li>
6666
<li>
6767
<strong>ChatGPT</strong>: download
68-
<a href="/h5p/skill/h5p-author-chatgpt.zip" download>h5p-author-chatgpt.zip</a> and upload it
68+
<a href="/h5p/skill/h5p-author.zip" download>h5p-author.zip</a>, the same file, and upload it
6969
under Plugins. ChatGPT's code cannot download the build tool, so download
7070
<a href="/h5p/bundles/h5p-author-build.tar.gz" download>h5p-author-build.tar.gz</a> once too.
7171
Make a Project in ChatGPT, add the archive to it, and ask in a chat of that project:
@@ -74,18 +74,17 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
7474
hands over the activity's source, to paste or open on the build page.
7575
</li>
7676
<li>
77-
<strong>Grok</strong>: download
78-
<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.
77+
<strong>Grok</strong> has no place to install a skill: download
78+
<a href="/h5p/skill/h5p-author.zip" download>h5p-author.zip</a>, the same file, and attach it
79+
to the message where you ask. Grok builds the <code>.h5p</code> file in the chat.
8180
</li>
8281
<li>
8382
<strong>An agent with a terminal</strong>, such as Claude Code, Codex or Cursor:
8483
<code>npx skills add missing-elements/h5p-offline-player --skill h5p-author</code>.
8584
</li>
8685
</ul>
8786
<p>
88-
The zips hold h5p-author {{ skill.version }}, the release the build page runs: text files and
87+
The zip holds h5p-author {{ skill.version }}, the release the build page runs: text files and
8988
nothing that runs, which you can read
9089
<a href="https://github.com/missing-elements/h5p-offline-player/tree/main/skills/h5p-author">on GitHub</a>.
9190
The archive holds the same release's build tool, which runs in the chat's own sandbox, and

‎src/h5p/skill/index.njk‎

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
layout: base.njk
33
title: The h5p-author skill · Missing Elements
4-
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.
4+
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.
55
# No script but the site's: base.njk writes the policy first in <head>, and the color-scheme script
66
# is added to script-src by its hash at build (eleventy.config.js).
77
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
1010
the skill from this page: the skill is installed, which is the guide's first step. The page
1111
stays for what names its address: the skill's route 3, and the copies of it already installed,
1212
which take the build tool's and the bundles' addresses from it where npm cannot be reached (as
13-
Grok built on 2026-11-13). The zips are served from this folder too. Its text files are not:
14-
the zips carry them, and a chat with the text alone, which read them here until 0.9.7, is one
13+
Grok built on 2026-11-13). The zip is served from this folder too. Its text files are not:
14+
the zip carries them, and a chat with the text alone, which read them here until 0.9.7, is one
1515
the skill is no longer offered to (the owner, 2026-11-15). -#}
1616
{#- Every address is written out whole, as its link's text too: a chat's fetch tool may open only
1717
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
2323
<header class="docs-header">
2424
<h1>The h5p-author skill</h1>
2525
<p class="lead">
26-
Its zips to install, and the files its build fetches where npm cannot be reached, each at its
26+
Its zip to install, and the files its build fetches where npm cannot be reached, each at its
2727
full address.
2828
</p>
2929
{#- A person opens this address too, to see what a prompt sends their chat to: they are told
@@ -40,7 +40,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
4040
<p>
4141
These are the files of h5p-author {{ skill.version }}, the release the build page at
4242
<a href="{{ site.url }}/h5p/build/">{{ site.url }}/h5p/build/</a> runs. The skill's text is in
43-
the zips, and on
43+
the zip, and on
4444
<a href="https://github.com/missing-elements/h5p-offline-player/tree/main/skills/h5p-author">GitHub</a>.
4545
</p>
4646
</header>
@@ -52,11 +52,10 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
5252
<p>
5353
In an agent with a terminal:
5454
<code>npx skills add missing-elements/h5p-offline-player --skill h5p-author</code>. In a chat
55-
app, from a zip:
55+
app, from one 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>
59-
<li><a href="{{ base }}h5p-author-chatgpt.zip">{{ base }}h5p-author-chatgpt.zip</a>: for ChatGPT's Plugins</li>
58+
<li><a href="{{ base }}h5p-author.zip">{{ base }}h5p-author.zip</a>: Claude's Skills and ChatGPT's Plugins take it, and Grok reads it attached to a message</li>
6059
</ul>
6160
</section>
6261

0 commit comments

Comments
 (0)