Skip to content

docs(unity-cli): align skill to CLI 1.0.0-beta.9 - #68

Merged
chris-addison merged 2 commits into
mainfrom
unity-cli/align-cli-1.0.0-beta.9
Sep 11, 2026
Merged

docs(unity-cli): align skill to CLI 1.0.0-beta.9#68
chris-addison merged 2 commits into
mainfrom
unity-cli/align-cli-1.0.0-beta.9

Conversation

@chris-addison

Copy link
Copy Markdown
Contributor

What & why

Mirrors the hub's skills/cli/ into the public skills/unity-cli/, aligning it to the released CLI 1.0.0-beta.9 (Unity-Technologies/unity-hub#12882 is the hub-side change this follows).

Documents the beta.9 surface that wasn't already covered: unity skill show, a new Plugin reference section (plugin install/remove/upgrade/list, plus plugin upgrade's new real version-comparison behavior and the new plugin changelog), the --color/--no-color global flag, unity auth consumers/revoke, unity config get/set/list/unset, unity doctor's bundled third-party-components section, the always-on cli telemetry usage ping, the sign-in token store's machine-sealing, and the self-installed-vs-Homebrew PATH-conflict warning. Also updates the --child-modules/--list-modules spellings (old --cm/--no-cm/--list-components still work) and the modules list Aliases column rename.

Two pieces of hub-ahead content are deliberately withheld from this publish because they describe CLI surface that hasn't shipped yet (both postdate the beta.9 candidate per the CLI's own changelog): the Unity Accelerator feature end to end (unity config accelerator, --accelerator/--no-accelerator, unity diagnose accelerator, the accelerator config key, doctor's Accelerator section), and one paragraph distinguishing unity vcs uvcs review's four auth-shaped error codes (a still-unreleased fix; the commands themselves are unaffected and stay documented, released since 1.0.0-beta.7).

new-unity-project and unity-package-management needed no changes this run — already in sync with their hub sources.

Changes

  • Added: unity skill show, the Plugin reference section, --color/--no-color, unity auth consumers/revoke, unity config get/set/list/unset, doctor's third-party-components section, the cli telemetry ping note, the token-store sealing note, the Homebrew PATH warning.
  • Changed: command index and global-flags/environment tables; --child-modules/--no-child-modules primary spelling; modules list's Aliases column; CHANGELOG.md's aligned-to stamp to 1.0.0-beta.9.
  • Removed: nothing (the two withheld pieces above were never published, so there's nothing to remove from the live public skill).

Also updated

  • README.md — N/A
  • non-owned public skill — N/A

Security / public-safety pass

  • Frontmatter parse gate (strict yaml): pass
  • Public-safety scan (no internal hosts/SSH/Jira keys/dev-only commands/credentials/local paths): pass (one grep hit on "collab" was a false positive — the public unity collaboration command name)
  • Hidden-Unicode (W021 / U+FE0F): scanned & clean
  • Install commands (W011/W012): unchanged, official public CDN over HTTPS — accepted inherent risk
  • /security-review: no findings (docs/changelog/version-bump diff only, no executable code)
  • Authoritative validator (validate-skills.mts --profile hub): unity-cli 0 errors (warnings pre-accepted via SECURITY.md); new-unity-project and unity-package-management clean

Generated with Claude Code

@chris-addison
chris-addison marked this pull request as ready for review September 8, 2026 21:27
@chris-addison
chris-addison requested a review from a team as a code owner September 8, 2026 21:27
Documents the beta.9 surface not already covered: unity skill show, a
new Plugin reference section (plugin install/remove/upgrade/list, plus
the new plugin upgrade version-comparison behavior and plugin
changelog), the --color/--no-color global flag, unity auth
consumers/revoke, unity config get/set/list/unset, unity doctor's
bundled third-party-components section, the always-on cli telemetry
ping, the sign-in token store's machine-sealing, and the
self-installed-vs-Homebrew PATH warning. Also updates the
--child-modules/--list-modules spellings and the modules-list Aliases
column, and refreshes the aligned-to stamp to 1.0.0-beta.9.

Withholds two pieces of hub-ahead content that describe CLI surface
not yet released: the Unity Accelerator feature end to end, and one
paragraph on unity vcs uvcs review's auth error codes (both postdate
the beta.9 candidate per the CLI's own changelog).

Generated with Claude Code
…ithheld list

Extends the in-progress beta.9 alignment with three things found while
completing it:

- The "Sandboxed agent tooling can hide a running Editor" guidance (hub
  CLI-1206) — a new integration-advanced.md section, a SKILL.md quickstart
  callout, and now also a callout inside the unity-status-first scene/
  GameObject/asset editing workflow, which previously had none. Extends the
  "don't fall back to hand-editing" bullet to also rule out quietly
  substituting an undisclosed workaround (e.g. a separate headless Editor
  invocation) for a disclosed file edit.
- A new version-control.md reference section for the `unity vcs` command
  family, which has shipped since 1.0.0-beta.7 but had no dedicated
  write-up. SKILL.md's UVCS day-to-day section is reworded to point at it
  and to name `review` alongside the other wrapped reads.
- A minor wording refinement to plugin upgrade's `indeterminate` outcome
  (still describing already-released behavior).

Also widens the Deferred list: three more pieces of hub-ahead content
landed in the hub's own docs after this alignment pass began and are held
back for the same reason as the already-withheld Accelerator feature and
uvcs-review auth-error paragraph — none has a published cli-v release yet.
`unity context` (save/use/list/current/delete), `unity commands` (plural,
machine-readable command-tree introspection), and `unity watch test`/
`unity watch build` are excluded from this publish.

Generated with Claude Code
@chris-addison
chris-addison force-pushed the unity-cli/align-cli-1.0.0-beta.9 branch from b395d24 to d47f14e Compare September 11, 2026 15:34
@chris-addison
chris-addison merged commit 6451582 into main Sep 11, 2026
3 checks passed
@chris-addison
chris-addison deleted the unity-cli/align-cli-1.0.0-beta.9 branch September 11, 2026 16:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants