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
6 changes: 4 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,13 @@ 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'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/skill/` | The skill as zips to install: `h5p-author.zip`, installed once in a chat's place for skills, or attached to the message in each new chat where it has none, and `h5p-author-chatgpt.zip`, the same skill laid out as a plugin; 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 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.
The pages go by what a chat has, not by its name (the owner, 2026-11-20): what one chat does changes within weeks, so no page says what a product does or lacks, and the chats in their titles are examples. What was seen is kept here and in the pages' comments, with its date.

A chat with a place for skills or plugins installs the skill from a zip, once (Claude's Skills and ChatGPT's Plugins, 2026-11-13). A chat with neither reads it from the zip attached to the message, in each new chat (Grok, 2026-11-15). An agent with a terminal takes it with `npx skills add`. `/h5p/create-with-ai/` says each. 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 (ChatGPT's, 2026-11-13), it builds from `h5p-author-build.tar.gz` once the person attaches it or keeps it in a project of the chat's (a ChatGPT Project on 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
13 changes: 8 additions & 5 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 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>
<p>The h5p-author skill is a zip of text files. A chat with a place for skills takes it once, and any other reads it attached to your message. An agent with a terminal, one that runs commands on your computer, installs it with one command.</p>
</li>
<li class="feature">
<span class="feature-icon icon-browser" aria-hidden="true"></span>
Expand All @@ -119,7 +119,10 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
</div>
</section>

{#- The prompt is a code block, which site.js gives a Copy button. It names the skill, which the
{#- The steps say what a chat can do, and name none: what one chat does changes within weeks, and
the guide goes by what the reader's chat has (create-with-ai/index.njk says why). The chats
in the page's title and under the heading are examples of an AI chat.
The prompt is a code block, which site.js gives a Copy button. It names the skill, which the
chat has once the first step is done, and the content type, so the chat asks nothing (since
2026-11-14 the skill asks for the type at most, and writes the author and licence the prompt
gives, or defaults): the sample is what Haiku wrote for this request, with the site's name and
Expand All @@ -129,20 +132,20 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
<div class="wrap">
<header class="band-head">
<h2 id="make-heading">How it works</h2>
<p>Three steps, in Claude, ChatGPT or Grok.</p>
<p>Three steps, in the AI chat you use: ChatGPT, Claude, Grok or another.</p>
</header>
<ol class="how" role="list">
<li>
<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>
<p>The h5p-author skill is the instructions that tell a chat how to write H5P. Download it and give it to your chat, once where the chat keeps skills, or with your message where it keeps none: <a href="/h5p/create-with-ai/#install">where it goes</a>.</p>
</li>
<li>
<h3>Ask your chat</h3>
<p>Paste the prompt below into a new chat, with a subject of your own. It names the type, so the chat asks nothing and writes the activity.</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 the activity's source, to <a href="#build-it">open or paste below</a>.</p>
<p>A chat whose code can run the build tool builds the <code>.h5p</code> file in the chat, from <a href="/h5p/create-with-ai/#archive">the build archive</a> where it cannot download the tool. Any other chat 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
Loading