Skip to content

Commit 57b4a1d

Browse files
committed
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
1 parent fbcbe0a commit 57b4a1d

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 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) |
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 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.
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

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.
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.
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 zip 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 zips 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 zip vite.config.ts writes to /h5p/skill/: its text files are not served
5+
// serves it only as the zips 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: 1 addition & 1 deletion
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 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>
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>

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

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -46,9 +46,10 @@ 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: 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
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. Grok has no place to install a skill, so it reads
52+
Claude's zip attached (the owner, 2026-11-15). The archive
5253
kept in a ChatGPT Project built there on the owner's free account on 2026-11-14 (#49). Its
5354
heading keeps the id that the top bar and the skill's page link to. -#}
5455
<section class="step" aria-labelledby="install">
@@ -65,7 +66,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
6566
</li>
6667
<li>
6768
<strong>ChatGPT</strong>: download
68-
<a href="/h5p/skill/h5p-author.zip" download>h5p-author.zip</a>, the same file, and upload it
69+
<a href="/h5p/skill/h5p-author-chatgpt.zip" download>h5p-author-chatgpt.zip</a> and upload it
6970
under Plugins. ChatGPT's code cannot download the build tool, so download
7071
<a href="/h5p/bundles/h5p-author-build.tar.gz" download>h5p-author-build.tar.gz</a> once too.
7172
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
7576
</li>
7677
<li>
7778
<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, in each new chat. Grok builds the <code>.h5p</code> file in
79+
<a href="/h5p/skill/h5p-author.zip" download>h5p-author.zip</a>, the same file as for
80+
Claude, and attach it to the message where you ask, in each new chat. Grok builds the <code>.h5p</code> file in
8081
the chat.
8182
</li>
8283
<li>
@@ -85,7 +86,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
8586
</li>
8687
</ul>
8788
<p>
88-
The zip holds h5p-author {{ skill.version }}, the release the build page runs: text files and
89+
The zips hold h5p-author {{ skill.version }}, the release the build page runs: text files and
8990
nothing that runs, which you can read
9091
<a href="https://github.com/missing-elements/h5p-offline-player/tree/main/skills/h5p-author">on GitHub</a>.
9192
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
125126
<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>
126127
</ul>
127128
<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.
129+
From the source, the build page builds it in your browser, plays it, and saves the file
130+
with Download the .h5p. A chat that built the file gives its source file too: open it on the
131+
build page to play the activity before you use it.
130132
</p>
131133
</section>
132134

‎src/h5p/skill/index.njk‎

Lines changed: 8 additions & 7 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 zip 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 zips 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 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
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
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 zip to install, and the files its build fetches where npm cannot be reached, each at its
26+
Its zips 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 zip, and on
43+
the zips, 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,10 +52,11 @@ 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 one zip:
55+
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>: Claude's Skills and ChatGPT's Plugins take it, and Grok reads it attached to a message</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>
59+
<li><a href="{{ base }}h5p-author-chatgpt.zip">{{ base }}h5p-author-chatgpt.zip</a>: for ChatGPT's Plugins</li>
5960
</ul>
6061
</section>
6162

0 commit comments

Comments
 (0)