Skip to content

Firm up step 6 with confirmed settings.json shape + usage note - #5

Open
jystewart wants to merge 1 commit into
mainfrom
claude/admin-setup-plugin-settings-json
Open

Firm up step 6 with confirmed settings.json shape + usage note#5
jystewart wants to merge 1 commit into
mainfrom
claude/admin-setup-plugin-settings-json

Conversation

@jystewart

Copy link
Copy Markdown
Contributor

Summary

Follow-up from actually testing the new-prototype plugin install end to
end. Step 6 previously just said "confirm the current steps in your admin
settings, this is evolving" — replaced that with the actual, tested path:

  • /plugin is terminal-CLI-only; it does not work in Claude Code on the
    web or the desktop app.
  • For web/desktop/org-wide, the plugin needs to be declared in
    .claude/settings.json (per-user/project) or managed settings (org-wide,
    via the admin console or a managed-settings.json file). Documented the
    confirmed-working shape — enabledPlugins is an object keyed by
    "plugin-name@marketplace-name", not an array, which isn't obvious from
    the settings docs and was the actual cause of a schema validation error
    hit while testing this.
  • Added a note that there's no /new-prototype slash command once
    installed — it's a skill, triggered automatically when a request matches
    the trigger phrases in SKILL.md's description, not a command to type.
    Someone hit exactly this confusion right after a successful install.

Test plan

  • Confirmed the enabledPlugins-as-object shape resolves the schema
    error that the array shape produced.
  • Confirmed skills are model-invoked, not slash commands — only
    commands/*.md files register a literal /name.

🤖 Generated with Claude Code

https://claude.ai/code/session_01QUdzgJV9npgquKJpAZRP8U


Generated by Claude Code

Replace the "confirm this yourself, it's evolving" hedge with the
actual, tested settings.json shape for enabling the plugin on web/
desktop/org-wide (enabledPlugins is an object keyed by
"plugin@marketplace", not an array — easy to get wrong and the
settings docs don't make it obvious).

Also add a note that there's no /new-prototype slash command to run
once installed — it's a skill, triggered by matching the description's
trigger phrases, not a command. Someone just hit exactly this
confusion after getting the plugin installed successfully.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QUdzgJV9npgquKJpAZRP8U
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