feat(author): the package carries the skill's text, and the skill gives a type file's address off GitHub

Merged
AL
20h ago
+62-33

Closes #178.

The Claude app, given a link to the h5p-author skill on GitHub, answered "I couldn't access the GitHub SKILL.md file due to rate limiting". GitHub limits anonymous requests per address on github.com and raw.githubusercontent.com, and a chat app fetches through addresses many users share. The skill then sent a chat that had its text back to raw.githubusercontent.com for a type's file.

Installing the skill stays the way: uploaded to the Claude app, added with npx skills add, pasted as a Chrome skill's prompt, nothing is fetched while the chat works. This is for a chat that cannot install one.

What changes

  • The package carries the skill's text. prepack copies SKILL.md and references/authoring.md beside the type files (scripts/copy-type-files.mjs is now copy-skill.mjs), each an export: @missing-elements/h5p-author/SKILL.md, @missing-elements/h5p-author/references/authoring.md. The organisation's site then serves the skill from the release its build page pins, in a pull request of its own.
  • The skill gives a type file's address off GitHub: https://missing-elements.github.io/h5p/build/types/<Type>.md, live since the build page carries the type files, in place of raw.githubusercontent.com's.
  • .gitignore, the package README, design/author.md and design/layout.md say so.

Tested

  • pnpm --filter @missing-elements/h5p-author test: 179 pass. The package test runs the copy, holds SKILL.md, the brief and every type file to the skill's own, and resolves each through the exports; dropping either new copy fails it. The typecheck passes.
  • pnpm --filter @missing-elements/h5p-skills test: 77 pass.
  • pnpm pack: the tarball is 0.8.0's files and SKILL.md and references/authoring.md.

To release

h5p-author 0.9.0, a minor for the two exports. Then the site's pull request serves the skill at missing-elements.github.io/h5p/skill/, with a page listing every file's full address: a chat's fetch tool may open only addresses it has seen whole, which a relative link or <Type> is not.

Summary by cubic

The h5p-author package now carries the skill's text (SKILL.md and references/authoring.md) alongside its type files, so the organization's site can serve the skill from a pinned release. The skill's type-file address changes from raw.githubusercontent.com to https://missing-elements.github.io/h5p/build/types/<Type>.md, avoiding GitHub's per-address rate limits that blocked chat apps from fetching skill files. Installing the skill stays as before; nothing is fetched while the chat works.

To release

  • Publish h5p-author 0.9.0 as a minor for the two new exports.
  • The site's pull request then serves the skill at missing-elements.github.io/h5p/skill/ with a page listing each file's full address, so a chat's fetch tool can open them.