Skip to content

fix(update-skills): prefer --scope managed for IT installs (0.27.1) - #2

Merged
richheadley merged 1 commit into
mainfrom
cursor/update-skills-managed-scope-aa88
Sep 9, 2026
Merged

richheadley merged 1 commit into
mainfrom
cursor/update-skills-managed-scope-aa88

Conversation

@richheadley

@richheadley richheadley commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Problem

The /update-skills coach (and the onboarding cheat sheet) led with:

claude plugin update mothy@mothy-marketplace

At Moth+Flame, installs are almost always Scope: managed (IT push). That bare update then fails with Plugin "mothy" is not installed at scope user, wasting a coaching round trip before the coach fell back to --scope managed in an "if error" subsection.

Fix

  1. plugins/mothy/skills/update-skills/SKILL.md

    • Step 1 branches on the Scope column from claude plugin list (managed vs user/project/local).
    • Step 2 itself leads with claude plugin update mothy@mothy-marketplace --scope managed when Scope was managed (still after marketplace update). Bare update is only for hand installs.
    • Wrong-scope errors remain as a fallback, not the primary path.
  2. docs/onboarding-claude-code-skills.md — same: managed is the normal M+F path; bare update only for hand installs.

  3. plugins/mothy/docs/ONBOARDING.md — no change; it only documents first-time marketplace add + install, not the update sequence.

  4. Version — patch bump 0.27.00.27.1 in plugin.json + marketplace.json.

Step 2 managed-first update path

Follow-up (not in this repo)

The skill still points Chat/Cowork at the parallel playbook mothy-mcp/playbooks/update-skills.md (update_skills_playbook_get). That file is not in mothy-plugins; mothy-mcp may need a matching edit so the MCP coach does not keep leading with the bare user-scope update.

Test plan

  • node --test tests/ (Node 20, same as CI / pre-push)
  • Assert Step 2 lists --scope managed before the bare update command
  • Manual: with a managed install, coach from Step 1 list output should issue --scope managed without an intervening bare-update failure

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

At Moth+Flame, mothy is almost always Scope: managed. Step 1 now
branches on Scope, and Step 2 leads with
`claude plugin update … --scope managed` for that path instead of
wasting a round trip on the bare user-scope update. Same guidance in
the onboarding cheat sheet. Bare update remains for hand installs.
@richheadley
richheadley marked this pull request as ready for review September 9, 2026 18:50
@richheadley
richheadley merged commit bb7ea50 into main Sep 9, 2026
2 checks passed
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