Repository navigation
feat!: make courses canonical and generate the skill and plugin from one intent list - #4
Merged
Merged
Conversation
Pin @bunizao/cli-kit to the unreleased feat/shared-nouns commit for the shared courses noun, intents and agent packaging. Switch to a released version once cli-kit publishes.
Use SHARED_NOUNS.courses for the top-level command. `ontrack courses` is now the canonical name; `units` and `projects` stay as aliases, so every existing invocation keeps working. Help and commands --json name the command `courses`. JSON output fields are unchanged.
Turn the intent tuples into cli-kit Intent objects and render SKILL.md, the Claude Code plugin and marketplace manifests and Codex metadata with agentFiles. `ontrack skills generate` now writes these files into the current directory instead of printing SKILL.md. Tests check that every intent command parses against the command tree and that the committed files are current.
SKILL.md links the command tree in references/commands.md instead of inlining it.
…k-cli The description now ends with "Use when …": the OnTrack phrases students use, and which sibling skill owns Moodle and Ed requests. The skill, its command reference and Codex metadata move from the repository root to skills/ontrack-cli/, which npx skills and Claude Code both discover, and the npm package ships that folder. Mutating intents drop their dry-run notes, since the kit's checklist now covers dry-run, confirm and read back.
# Conflicts: # SKILL.md # src/cli-app.ts # src/skill.ts
bunizao
marked this pull request as ready for review
October 29, 2026 09:26
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
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.
Moves ontrack onto the shared nouns and intent list from bunizao/cli-kit#1.
coursesis the canonical noun.unitsandprojectsstay as aliases, so every existing command still works. Help,commands --jsonand the README now saycourses. JSON fields are unchanged.INTENTSinsrc/skill.tsis a cli-kitIntent[].skills generatewrites the skill folderskills/ontrack-cli/(SKILL.md,references/commands.md,agents/openai.yaml) and.claude-plugin/into the current directory instead of printing SKILL.md, matching moodle. The root SKILL.md is gone;npx skills addand Claude Code both find the folder, and the npm package ships it.claude plugin marketplace add bunizao/ontrack-cliand thenclaude plugin install ontrack-cli@ontrack-cli.claude plugin validate . --strictpasses.npm test. Every intent command must parse against the real command tree, and the committed agent files must match whatskills generatewould write.Before merging
@bunizao/cli-kit@^0.7.0, which is now on npm.mainin:doctorjoins the help groups, the skill table points atdoctor --live --cookieswhen sign-in still fails, and main's three new sign-in rules are condensed into two. The cookie-adoption timing and the DevTools snippet stay indocs/auth.md, since an agent never acts on them.plugin.jsoncarries the package version, so runnpm run skill:generateafter every version bump or the stale-file test fails.Not in this PR
chats readstill marks comments read. The skill states that as an exception to the sharedreadrule; splitting it out is part of the verb work.evals/trigger.mjs(Codex, 3 runs): ontrack-cli fires on 9 or 10 of 10 OnTrack requests depending on the pass, and on no Moodle or Ed request. A request to set up a Doubtfire dev instance still opens this skill, and a "Not for" clause didn't stop it, so the description leaves that out.ontrack units …, which works through the alias.Tests
npm test: 161/161.npm run typecheckpasses.