plugin-installer

Deploy plugin components into the .agents/ store with environment symlinks.

5|3|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/richfrem/agent-plugins-skills --skill plugin-installer-richfrem
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plugin-installer
Source: https://github.com/richfrem/agent-plugins-skills/tree/main/plugins/plugin-manager/skills/plugin-installer
Command: npx skills add https://github.com/richfrem/agent-plugins-skills --skill plugin-installer-richfrem

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Installs plugin components (skills, commands/workflows, rules, hooks, MCP) into the .agents/ central store and symlinks them to agent environments that require it (.claude/). The process supports both interactive and headless installations, ensuring consistent deployments across environments.

Core Features & Use Cases

  • Centralized installation into the canonical .agents/ store with environment-specific symlinks
  • Full-stack deployment of skills, commands, rules, hooks, and MCP
  • Flexible execution paths: interactive TUI via plugin_add.py and headless OS-level installation via plugin_installer.py
  • Automatic lock-file updates to track locally installed plugins and bridge-installed components
  • Works across multiple agent targets (Claude Code and other supported environments)

Quick Start

Install a plugin from a GitHub repo and run the installer to deploy components into .agents and link to Claude Code environments.

Frequently Asked Questions about plugin-installer

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

FAQPage Schema
How do I install plugins into a central .agents store and symlink them to my agent environment?

To install plugins into a central .agents store, this workflow deploys skills, commands, rules, and hooks while automatically creating environment-ready symlinks to targets like .claude/. It handles full-stack installation across agent environments with consistent deployments.

Does the plugin installer support headless automated deployment for CI workflows?

Yes, the plugin installer supports headless automated deployment for CI workflows via the plugin_installer.py script. This allows OS-level installation of skills, rules, and hooks without interactive prompts, ensuring consistent automated deployments.

Can I use this installer to deploy custom workflows and hooks into Claude Code?

Yes, you can use this installer to deploy custom workflows and hooks into Claude Code. It bridges installed components from the canonical .agents/ store by symlinking them directly into the .claude/ directory for immediate use.

What is the best way to track installed agent skills and plugins across a project?

The best way to track installed agent skills and plugins is through automatic lock-file updates. The installer modifies local and project-level skill lock files during deployment to maintain an accurate record of bridge-installed components.

Do I need external Python dependencies to run the plugin deployment workflow?

No, you do not need external Python dependencies to run the plugin deployment workflow. It requires only Python 3.8 or higher and uses exclusively the standard library to execute installations and manage symlinks.

Why use a centralized .agents store instead of installing skills directly into my agent directory?

Using a centralized .agents store separates canonical plugin sources from environment-specific configurations via symlinks. This approach ensures consistent deployments, simplifies updates, and manages full-stack components across multiple agent targets without duplication.