claudekit / guides / first-plugin
[ Guide · Beginner · 8 min ]

Installing Your First Plugin

published · updated

A step-by-step walkthrough for installing your first Claude Code plugin. Find one in the marketplace, install it, and confirm how to use it afterward.

What is a plugin?

A Claude Code plugin is a directory of skills, agents, hooks, MCP servers, or other components that Claude Code installs and loads as one unit. Install one from a marketplace and the bundled capabilities all become available at once.

Official docs: Install and manage plugins — covers install scopes and other surfaces such as the desktop app.

Two marketplace types

1. Anthropic’s official marketplace

Claude Code adds Anthropic’s official marketplace (anthropics/claude-plugins-official, named claude-plugins-official) for you the first time you start an interactive terminal session, so plugins from it install directly:

/plugin install superpowers@claude-plugins-official

2. Other marketplaces

For other marketplaces, add them first:

/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills

The marketplace short name (@karpathy-skills) is set in the marketplace definition.

Browse and verify installed plugins

/plugin

/plugin opens on the Discover tab, which lists the plugins from your marketplaces; type to search. Press Tab to move between tabs: the Installed tab lists your plugins with actions to enable, disable, update, or uninstall each one, and the Errors tab shows why a plugin failed to load.

First plugin — install Superpowers

/plugin install superpowers@claude-plugins-official

Superpowers works through skills, not slash commands. The legacy /brainstorm, /write-plan, and /execute-plan commands were removed in v5.1.0. Key skills include:

  • superpowers:brainstorming — explore ideas and requirements
  • superpowers:writing-plans — write an implementation plan
  • superpowers:executing-plans — execute a plan step by step
  • Plus test-driven-development, systematic-debugging, and more

Describe what you want to do and Claude loads the matching skill, or run one directly, for example /superpowers:brainstorming.

Second pick — Commit Commands

/plugin install commit-commands@claude-plugins-official

Automates the commit, push, and PR creation workflow. After install, /commit-commands:commit, /commit-commands:commit-push-pr, and others appear in the / menu.

Manage plugins

/plugin                                # Discover, Installed, Marketplaces, Errors tabs
/plugin install <name>@<marketplace>   # install
/plugin uninstall <name>               # remove
/reload-plugins                        # apply pending changes without restarting
  • Updates: plugins from Anthropic’s official marketplace update automatically by default. After an update, run /reload-plugins to apply it, or the next session loads the new version. To update one plugin now, open it on the Installed tab and select Update now, or run claude plugin update <plugin>@<marketplace> in your shell.
  • Disable without uninstalling: use the Installed tab, or claude plugin disable in your shell.

Note: enabled plugins cost context every session

An enabled plugin is part of every session, not only the sessions where you use it. For each skill and agent Claude can invoke on its own, the name and description are in Claude’s context on every turn.

  • Before you install: plugins in Anthropic’s official marketplace show a Context cost estimate in their details
  • After you install: run claude plugin details <name> in your shell to see the tokens it adds to every session, and check the Installed tab’s Not used recently group for plugins you could turn off

Tip: vet your marketplaces

What a plugin runs, it runs as you, so check the source. Claude Code groups marketplaces into three tiers:

  • Official: Anthropic’s official marketplace names, such as claude-plugins-official and knowledge-work-plugins
  • Community: claude-community, claude-plugins-community, and healthcare. Where the claude-community catalog pins a plugin to a commit SHA, Claude Code refuses to install a different commit
  • Third-party: every other marketplace. Read the README and source before installing

On claude.com/plugins, look for the “Anthropic verified” label.

Next steps

§ 10

Frequently Asked Questions

frequently asked
§ 10.1
What is a plugin?
A directory of skills, agents, hooks, MCP servers, or other components that Claude Code installs and loads as one unit. Most plugins come from a marketplace, a catalog that lists plugins and where to fetch each one.
§ 10.2
Where do I find plugins?
Officially listed plugins are searchable at https://claude.com/plugins, and inside Claude Code the Discover tab in `/plugin` lists the plugins from your marketplaces. Third-party marketplaces hosted on GitHub can be added directly and installed from.
§ 10.3
How do I install one?
Plugins from Anthropic's official marketplace install with `/plugin install <name>@claude-plugins-official`. For another marketplace, run `/plugin marketplace add <owner/repo>` first, then `/plugin install <name>@<marketplace>`.
§ 10.4
How do I use a plugin after installing?
Type `/` and look for the plugin's skills under its name, in the form `/<plugin>:<skill>` (for example, `/commit-commands:commit`). The Installed tab in `/plugin` lists installed plugins with their scope.
§ 10.5
Which plugins should I install first?
Superpowers (brainstorming, TDD, systematic debugging) and Commit Commands (git automation). Both deliver immediate value and fit common dev workflows.