plugin-management

Manage Claude Code plugin installation, updates, removal, and troubleshooting.

3|1|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/nsheaps/ai-mktpl --skill plugin-management-nsheaps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-management
Source: https://github.com/nsheaps/ai-mktpl/tree/main/plugins/plugin-management/skills/plugin-management
Command: npx skills add https://github.com/nsheaps/ai-mktpl --skill plugin-management-nsheaps

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers and maintainers install, update, verify, and troubleshoot Claude Code plugins across user, project, and local scopes, clarifying when changes hot-reload versus when a restart or manual cache operations are required.

Core Features & Use Cases

  • Marketplace and scope management: Explains how to add plugins via marketplaces and which settings files (user, project, local) persist plugin entries.
  • Update, reload, and restart guidance: Details which components hot-reload (settings.json, plugin install/uninstall) and which require /clear, /compact, or a full restart (skills, plugin code, MCP servers).
  • Verification and troubleshooting: Describes checking the plugin UI, running debug mode, validating plugin manifests, inspecting the plugin cache, and known issue workarounds.

Quick Start

Ask the assistant to install plugin-name@marketplace into the project scope and report whether a restart, a plugin reload, or a /clear is required to apply the change.

Frequently Asked Questions about plugin-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install a Claude Code plugin from a marketplace into my project scope?

To install a Claude Code plugin from a marketplace, you add the plugin entry to the appropriate settings.json file for your desired scope, such as user, project, or local. The plugin is then installed directly from the marketplace into that selected scope.

Does updating settings.json hot-reload Claude Code plugins or do I need a full restart?

Updating settings.json and installing or uninstalling plugins hot-reloads automatically. However, changes to plugin code, skills, and MCP servers require a /clear, /compact, or a full application restart to apply the updates.

Why is my Claude Code plugin not working after an update?

A Claude Code plugin may not work after an update if the plugin cache is stale. You can troubleshoot this by running debug diagnostics, validating the plugin manifest, and applying memoized cache clearing or a full restart to apply the changes.

How do I troubleshoot Claude Code plugin cache issues during development?

To troubleshoot Claude Code plugin cache issues, inspect the plugin cache and run debug diagnostics to identify stale entries. Apply memoized cache clearing or manage hot-reloads versus restarts to resolve lifecycle problems during development.

Can I manage Claude Code plugins across different settings scopes?

Yes, you can manage Claude Code plugins across user, project, and local scopes. The settings.json file for each scope persists the respective plugin entries, allowing you to control plugin availability based on your development context.