Repository navigation
The guide goes by what a chat has, not by its name - #81
Merged
Merged
Conversation
The how-to and the build page gave their steps by product: where the skill goes in Claude, ChatGPT and Grok, which of them builds the file, and what each lacks. Grok imported the zip under Skills on 2026-11-13 and had no place for one two days later, so such a step sends its reader the wrong way until it is edited again. Each step now names what a reader can look for in their own chat and says what to do with it and without it: a place for skills, plugins, or neither for the skill; code that runs Node.js and gets the build tool, or the source for the build page; and for the build archive a project, or the message. No page says what one product does or lacks. The chats in the titles stay as examples, and what was seen in each chat stays in the comments and the README with its date. The help entry on a chat's link said a link is made by running code: the skill gives the build page's plain address and no link (h5p-toolkit#215). Closes #80.
alekswebnet
force-pushed
the
docs/guide-by-capability
branch
from
November 20, 2026 07:42
216facc to
d5bcecc
Compare
There was a problem hiding this comment.
Review completed against the latest diff
Reply with feedback, questions, or to request a fix.
View guided diff | Turn on auto-fix | Re-trigger cubic
…as one layout From the review of #81: - an agent with a terminal comes before the cases and outside them: taken in order, the cases sent it to the zip attached to each message before it reached `npx skills add`; - the plugin case says plugins come in more than one layout, and that a chat which refuses this one takes the zip attached; - the skill page and the README say "installed once" against "attached to the message in each new chat".
There was a problem hiding this comment.
All reported issues were addressed across 3 files (changes from recent commits).
Reply with feedback, questions, or to request a fix.
View guided diff | Turn on auto-fix | Re-trigger cubic
There was a problem hiding this comment.
All reported issues were addressed across 2 files (changes from recent commits).
Reply with feedback, questions, or to request a fix.
View guided diff | Turn on auto-fix | Re-trigger cubic
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #80.
The how-to and the build page gave their steps by product: where the skill goes in Claude, ChatGPT and Grok, which of them builds the file, and what each lacks. Chats change within weeks, as Grok's place for skills did between 2026-11-13 and 2026-11-15, and each change left a step sending its reader the wrong way. The pages now go by what a chat has, which a reader can see in their own chat.
What changes
h5p-author.zip, once. A switch for running code, if there is one, goes on.h5p-author-chatgpt.zip, the same skill laid out as a plugin. The case says that plugins come in more than one layout, and that a chat which refuses this one takes the zip attached..h5pwhere its code runs Node.js and gets the build tool, and the source otherwise. The build archive moves here from step 1, with its own#archiveanchor. Nobody knows beforehand whether a chat's code can download the tool, and the skill's reply offers the archive where it would help. It goes into a project where the chat has projects, and with the message where it has none or the chat does not find it there.#archive.What stays
vite.config.ts, which are dated records of what was tried.Tested
pnpm install --frozen-lockfileandpnpm build, which runstsc, pass.#archiveamong them.Summary by cubic
The guide and build page now describe steps by what a chat has — a place for skills, plugins, projects, or code that runs — rather than by naming Claude, ChatGPT, or Grok.
#archiveanchor; help entries, the README, and the skill page describe the two zips by what takes them.Written for commit 62966e9. Summary will update on new commits.