Plugins

Plugins are packages of AI tooling that can be shared across projects and clients.

Plugin Structure

my-plugin/
├── skills/          # Cross-client skills
├── agents/          # Agent definitions (Claude, Copilot, Factory)
├── hooks/           # Hook definitions (Claude, Copilot, Factory)
├── commands/        # Commands (Claude, OpenCode)
├── .github/         # GitHub overrides (Copilot, VSCode)
│   ├── copilot-instructions.md
│   ├── instructions/    # Pattern-based instructions
│   ├── prompts/         # Prompt files
│   ├── agents/          # GitHub agent overrides
│   └── hooks/           # GitHub hook overrides
└── AGENTS.md

Duplicate Skill Handling

When multiple plugins define skills with the same folder name, AllAgents automatically resolves naming conflicts:

Conflict Type	Resolution	Example
Same skill folder, different plugins	{plugin}_{skill}	plugin-a_coding-standards
Same skill folder AND plugin name	{org}_{plugin}_{skill} (GitHub)	acme_my-plugin_coding-standards
Same skill folder AND plugin name	{hash}_{plugin}_{skill} (local)	a1b2c3_my-plugin_coding-standards

Skills with unique folder names keep their original names unchanged.

Example:

workspace.yaml

plugins:
  - ./plugin-a    # has skills/coding-standards/
  - ./plugin-b    # has skills/coding-standards/
  - ./plugin-c    # has skills/testing/

After sync:

.claude/skills/
├── plugin-a_coding-standards/   # renamed (conflict)
├── plugin-b_coding-standards/   # renamed (conflict)
└── testing/                     # unchanged (unique)

Adding Skills

You can add a specific skill from a GitHub repo without installing the full plugin first:

# Add a skill by name, specifying the plugin source
allagents skills add reddit --from ReScienceLab/opc-skills

# Or pass a GitHub URL directly
allagents skills add https://github.com/owner/repo/tree/main/skills/my-skill

This installs the plugin and enables only the specified skill. See the CLI reference for all source formats.

Disabling Individual Skills

You can disable specific skills from a plugin without uninstalling the entire plugin:

# List all skills with their status
allagents plugin skills list

# Disable a skill
allagents plugin skills remove brainstorming

# Re-enable a skill
allagents plugin skills add brainstorming

Disabled skills are stored in disabledSkills in workspace.yaml and are excluded from sync:

plugins:
  - superpowers@official

disabledSkills:
  - superpowers:brainstorming

When a skill exists in multiple plugins, use --plugin to specify which one:

allagents plugin skills remove coding-standards --plugin my-plugin

Plugin Spec Format

Plugins use the plugin@marketplace format:

Format	Example
Well-known	code-review@claude-plugins-official
owner/repo	my-plugin@owner/repo