Plugin Installation Skill

Purpose

Manages the installation, update, and removal of plugins from the marketplace.

When to Use

• User wants to install a new plugin
• User wants to update installed plugins
• User wants to remove a plugin
• User wants to check for updates

Related Commands

• /install <name> - Install a plugin
• /uninstall <name> - Remove a plugin
• /plugins - List installed plugins
• /update <name> - Update a plugin

Operations

1. Install Plugin

Steps:

1. Validate plugin exists in registry
2. Load plugin manifest
3. Check dependencies (install if missing)
4. Verify required configuration
5. Copy/link plugin contents
6. Run post-install hooks
7. Update installed.json

Input:

{
  "pluginName": "skills-jira",
  "version": "latest",
  "skipDeps": false
}

Output:

## Installed: skills-jira v1.0.0

Contents added:
- 8 skills in skills/jira/

Configuration required:
- jira.cloudId - Run /configure to set
- jira.projectKey - Run /configure to set

2. Uninstall Plugin

Steps:

1. Verify plugin is installed
2. Check for dependent plugins
3. Run pre-uninstall hooks
4. Remove plugin contents
5. Run post-uninstall hooks
6. Update installed.json

Input:

{
  "pluginName": "skills-security",
  "keepConfig": false,
  "force": false
}

Output:

## Uninstalled: skills-security

Removed:
- 4 skills from skills/security/

Note: Configuration entries remain in project.json

3. Update Plugin

Steps:

1. Check current installed version
2. Fetch latest version from registry
3. Compare versions
4. Download and apply updates
5. Run migration hooks if needed
6. Update installed.json

Input:

{
  "pluginName": "agent-senior-developer",
  "targetVersion": "latest"
}

Output:

## Updated: agent-senior-developer

1.0.0 → 1.1.0

Changes:
- Added new TDD templates
- Improved code review prompts
- Fixed edge case in PR creation

4. Check for Updates

Steps:

1. Read installed.json
2. Compare each plugin version with registry
3. Report available updates

Output:

## Available Updates

| Plugin | Installed | Latest | Breaking |
|--------|-----------|--------|----------|
| skills-jira | 1.0.0 | 1.1.0 | No |
| agent-qa-engineer | 1.0.0 | 2.0.0 | Yes |

Run `/update <name>` to update.

5. List Installed

Steps:

1. Read installed.json
2. Format and display

Output:

## Installed Plugins (4)

| Plugin | Type | Version | Installed |
|--------|------|---------|-----------|
| ai-dev-team-full | bundle | 1.0.0 | 2026-01-09 |
| skills-jira | skill | 1.0.0 | 2026-01-09 |
| ...    | ...  | ...     | ...       |

Data Files

• Registry: marketplace/registry.json (read-only)
• Installed: marketplace/installed.json (read-write)
• Manifests: marketplace/plugins/{type}/{name}/manifest.json

Dependency Resolution

When installing a plugin with dependencies:

1. Build dependency tree
2. Detect circular dependencies (error)
3. Install in topological order (leaves first)
4. Record auto-installed plugins

{
  "skills-jira": {
    "version": "1.0.0",
    "autoInstalled": true,
    "installedBy": "ai-dev-team-core"
  }
}

Configuration Handling

After installation, check requiredConfig:

1. Read current config/project.json
2. Identify missing required fields
3. Prompt user to configure
4. Optionally run /configure helper

Error Handling

Error	Solution
Plugin not found	Check spelling, suggest similar
Version not found	Show available versions
Dependency conflict	Show conflicting requirements
Missing config	List required config, suggest /configure
Install hook failed	Show error, offer rollback

Used By Agents

• Orchestrator (for plugin recommendations)
• All agents (for self-service plugin management)