Grok takes the skill zip attached, and the guide stops promising a link

Merged
AL
2d ago
+45-47

Closes #62. Stacked on #60, which this branch starts from: its two commits show here until it merges.

The two zips stay. One zip for every chat app was tried and is not possible:

  • A zip holding both layouts was uploaded on 2026-11-16. ChatGPT's Plugins took it. Claude's Skills refused it: "All files must be inside the top-level folder" and "Zip must contain exactly one SKILL.md file. Currently there are 2."
  • ChatGPT refuses the folder-at-root layout that Claude's Skills want, so no one zip satisfies both.
  • The plugin layout alone would go into Claude under Plugins, which Anthropic lists for paid plans only. Skills take a zip on the free plan.

What changes:

  • Guide, step 1: Grok has no place to install a skill, so it takes h5p-author.zip, Claude's file, attached to the message, in each new chat. The step's first sentence says the skill stays in Claude and ChatGPT.
  • Guide, step 4: a chat hands over the .h5p file or the source, not a link, and a chat that built the file gives its source file too, to play on the build page.
  • The build page, the skill page and the README say the same about Grok, and the build page's step 3 no longer promises ChatGPT's link.
  • vite.config.ts: the zips are written as before; the comment records the one-zip test and why it failed.

Checked: pnpm build and pnpm typecheck pass, and the site writes h5p-author.zip and h5p-author-chatgpt.zip as on main.

The pin: h5p-author 0.10.3, published from missing-elements/h5p-offline-player@12cc87d. From it Grok builds in the chat with no archive (the owner's test, 2026-11-16), and a package built in a chat comes with its source file and the build page's plain address, with no link (missing-elements/h5p-offline-player#212, #216).

Checked with the pin: pnpm install --frozen-lockfile, pnpm build and pnpm typecheck pass. Both zips' skill files equal npm's 0.10.3 tarball, plugin.json says 0.10.3, and the build archive's tool answers 0.10.3 and builds a True/False that passes the verifier.


Summary by cubic

Keeps the two skill zips: one for Claude's Skills, one for ChatGPT's Plugins. A single zip holding both layouts was refused by Claude's Skills, so the consolidation is dropped; Grok, which has no place to install a skill, reads h5p-author.zip attached to a message in each new chat.

  • Claude and ChatGPT install the skill once and keep it, while Grok takes the zip with each message; the guide's first step is now "Give your chat the skill" instead of "Install the skill, once".
  • ChatGPT without the build archive now hands over the activity's source instead of a link.
  • Open WebUI is dropped: its Import from URL install and Open Terminal build were found not to work.
  • h5p-author is pinned to 0.10.3, which the guide's claim that Grok builds in the chat relies on; a chat-built package now carries its source and the build page's plain address.
  • pnpm build and pnpm typecheck pass, and the built zips match what the owner uploaded.