Guides
    claude code
    plugins
    skills

    Claude Code Plugins vs Skills — What's the Difference? (2026)

    Claude Code now has a plugin system AND a skills system. Here's what plugins are, how they differ from skills, and why the distinction matters for your workflow.

    April 15, 20267 min read0 views
    Share:

    Claude Code recently shipped a full plugin system. You can now run /plugin in your terminal to browse, install, and manage extensions from plugin marketplaces. If you were already using SKILL.md skills, you might be wondering: what's the difference? Do plugins replace skills? Do I need both?

    Short answer: plugins are the distribution format. Skills are the content. Plugins bundle skills (and more) into installable packages.

    What a plugin actually is

    A plugin is a folder with a plugin.json manifest that can contain any combination of:

    • Skills — the same SKILL.md files you already know
    • Agents — sub-agents that run as isolated tools
    • Hooks — scripts that trigger on specific events (pre-commit, post-edit, etc.)
    • MCP servers — external service connections bundled with the plugin
    • Slash commands — custom /commands you can invoke directly

    When you install a plugin, you get everything inside it. A plugin called commit-commands might include a skill for writing commit messages, a hook that runs before every commit, and a slash command /commit to trigger it manually.

    How the plugin system works

    Open Claude Code and type /plugin. You'll see four tabs:

    Discover — browse available plugins from your connected marketplaces. Installed — manage what you've already installed. Marketplaces — add or remove plugin sources. Errors — troubleshoot anything that failed to load.

    The official Anthropic marketplace (claude-plugins-official) is pre-configured. It contains verified plugins maintained by Anthropic and approved third-party creators.

    To add a community marketplace:

    /plugin marketplace add owner/repo
    

    This accepts GitHub repos, Git URLs, or local paths. After adding a marketplace, its plugins show up in the Discover tab.

    Skills still work the same way

    Here's the important part: if you already have SKILL.md files in ~/.claude/skills/ or .claude/skills/, they still work. Nothing changed. The plugin system is additive — it's a new way to discover and install skills, not a replacement for the skills directory.

    The relationship:

    MethodHow it worksBest for
    Manual skillsDrop SKILL.md into ~/.claude/skills/Custom skills you wrote yourself
    Plugin install/plugin install name@marketplaceCommunity and marketplace skills
    MCP connectionAgent pulls skills on demandLive access without managing files (Agensi Pro)

    All three can coexist. You might have custom skills in your skills folder, plugins installed from the Anthropic marketplace, and an MCP connection to Agensi for on-demand skill access.

    The marketplace landscape

    Multiple plugin marketplaces already exist:

    Official Anthropic marketplace — pre-configured, contains verified plugins. Small but curated.

    Community GitHub repos — anyone can create a marketplace.json file in a GitHub repo and distribute plugins. Quality varies enormously.

    Agensi — marketplace for individual SKILL.md skills with security scanning. Also offers MCP-based live access so your agent can pull skills on demand without installing plugins.

    Directory sites — several indexing sites have appeared that aggregate plugins and skills from GitHub. These are discovery layers, not curated marketplaces.

    Security considerations

    The plugin system introduces new security surface area. A plugin can include hooks (scripts that run automatically on events), MCP servers (external connections), and slash commands (executable workflows). This is more powerful than a SKILL.md skill, which is just instructions.

    Before installing a plugin:

    • Check the source marketplace. Official Anthropic plugins are verified. Community plugins are not.
    • Read what the plugin contains. Does it include hooks or MCP servers? Those execute code on your machine.
    • Check the creator's profile and repository activity.

    For skills specifically, Agensi security-scans every submission before listing — checking for dangerous commands, hardcoded secrets, prompt injection, and obfuscated code. The plugin system doesn't have this level of review for community marketplaces.

    When to use plugins vs skills vs MCP

    Use manual skills when:

    • You wrote the skill yourself for your specific project
    • You bought a skill from a marketplace and want a local copy
    • You want full control over what's installed

    Use plugins when:

    • You want a complete package (skill + hooks + commands)
    • You want easy install/update via /plugin
    • You're using the official Anthropic marketplace

    Use MCP when:

    • You want your agent to discover and load skills automatically
    • You don't want to manage files or plugins manually
    • You want access to a full catalog without installing everything

    Agensi Pro combines the best of both: security-scanned skills delivered via MCP, so your agent gets live access to the full catalog without manual installs. Your agent evaluates each skill and only loads what will actually improve its output for your current task.

    Setting up all three

    # 1. Manual skills (already works)
    ls ~/.claude/skills/
    
    # 2. Add the Anthropic plugin marketplace (already configured)
    /plugin
    
    # 3. Add Agensi MCP for on-demand skills
    # In .claude/settings.json:
    {
      "mcpServers": {
        "agensi": {
          "url": "https://mcp.agensi.io"
        }
      }
    }
    

    Browse security-scanned skills at Agensi or connect via MCP for live agent access.

    Find the right skill for your workflow

    Browse our marketplace of AI agent skills, ready to install in seconds.

    Browse Skills

    Related Articles