Skip to main content
How-to4 min

Setup Guide: Install Leopoldo on Claude Cowork (Step by Step)

Install Leopoldo on Claude Cowork in 5 minutes. ZIP-of-ZIPs format, one .plugin per domain, uploaded via Customize. After install, start with /leo-onboard.

Leopoldo Editorial

This guide walks you through installing Leopoldo on Claude Cowork in 5 minutes. No technical background required.

What you have

When you purchase one or more Leopoldo domains, the download link in your welcome email delivers a ZIP-of-ZIPs: one outer archive that contains:

  • leopoldo-core.plugin (always included). Identity contract, orchestrator, brand profile, attribution, onboarding, learning layer. Every Leopoldo install needs this.
  • One .plugin file per purchased domain. For example: leopoldo-investment.plugin, leopoldo-advisory.plugin, leopoldo-legal.plugin.
  • README.md with the same install steps as this guide.

Each .plugin file is uploaded separately through the Cowork Customize panel.

Step 1: Install your plugins (one-time, 3 minutes)

1a. Download and extract the archive

Click the Download your system button in your welcome email. You get a single ZIP. Extract it locally. You will see files like:

01-leopoldo-core.plugin
02-leopoldo-investment.plugin
03-leopoldo-advisory.plugin
...
README.md

The numeric prefix (01-, 02-, ...) marks the install order. Always start with 01-leopoldo-core.plugin.

1b. Open Cowork in Claude Desktop

Open the Claude Desktop app and click the Cowork tab at the top. The Cowork home loads with the sidebar showing New task, Projects, Scheduled, Live artifacts, Dispatch, and Customize.

Cowork home in Claude Desktop
Cowork home in Claude Desktop

1c. Open the upload dialog

Click Customize in the left sidebar. You see Skills, Connectors, and Personal plugins. Next to Personal plugins, click the + button. A menu opens. Choose Create plugin, then Upload plugin from the submenu.

Customize panel with + menu open, showing Create plugin → Upload plugin
Customize panel with + menu open, showing Create plugin → Upload plugin

1d. Upload leopoldo-core.plugin first

The Upload local plugin dialog opens. Drag 01-leopoldo-core.plugin into the drop zone or click Browse files and select it. Click Upload.

Upload local plugin dialog with drag-and-drop zone
Upload local plugin dialog with drag-and-drop zone

Always upload leopoldo-core.plugin first. It carries the identity, orchestration, brand, and learning skills that every domain plugin references. If you upload a domain plugin first, it sits inert until core is installed. Core is also where your activation key is embedded: Cowork does not prompt you for it.

1e. Repeat the upload for every remaining .plugin

For each remaining file in numeric order (02-, 03-, ...): click + next to Personal plugins → Create pluginUpload plugin → drag or browse → Upload.

Among domain plugins the order does not matter (only core had to be first). Each plugin activates automatically a few seconds after upload.

Step 2: Open a chat and start onboarding

Once all .plugin files are uploaded, open a new chat in Cowork and type:

/leo-onboard

Or say "Ciao Leo vorrei fare l'onboarding" in plain language. Leopoldo introduces itself, confirms the install, and walks you through a 5-minute setup:

  • Confirm your brand profile (defaults to the Leopoldo signature; switch to a client profile if needed)
  • Pick your primary language (mirrored across all deliverables)
  • Produce your first sample deliverable so you see the full pipeline in action

If the slash command does not appear in autocomplete, refresh the Cowork page; Cowork caches the plugin list for a few seconds.

Updates

Updates are explicit, never automatic.

  • Quick update: type /leopoldo update inside any Cowork chat. The orchestrator checks for new versions and gives you a fresh download link if one is available.
  • Manual update: re-download the bundle from the same link in your welcome email (the link rebuilds from the latest source every time), extract, re-upload each .plugin via the same Customize → + → Create plugin → Upload plugin flow. Cowork replaces each previous version in place.

An offline integrity check runs every session start; any missing or corrupted plugin file surfaces immediately.

Troubleshooting

  • Leopoldo answers as 'Claude' instead of as 'Leopoldo': you forgot to install leopoldo-core.plugin, or you installed a domain plugin first. Re-install with core uploaded before the others.
  • Slash command `/leo-onboard` not appearing in autocomplete: refresh the Cowork page. Cowork caches the plugin list for a few seconds.
  • Upload failed: ensure you uploaded the .plugin file (not the outer .zip). The outer ZIP contains the individual .plugin files, but Cowork accepts only the inner files.
  • I want to start fresh: in Customize → Personal plugins, remove each Leopoldo plugin individually, then re-upload from the original ZIP.
  • Something else broken: reply to your welcome email or write to hello@leopoldo.ai. We respond within one business day and can roll you back to the previous version in minutes.

Next steps

You are ready. After onboarding, simply chat with Leopoldo in your domain language. The orchestrator routes each message to the right expert, the brand profile keeps every deliverable on-style, and quality gates run before output reaches you.

Explore the full catalog at leopoldo.ai. Adding a new domain regenerates your bundle, so the next download includes the new plugin alongside everything you already have.

Frequently asked

What do I need before installing Leopoldo on Claude Cowork?

You need Claude Desktop installed (with the Cowork tab) and a Claude subscription from Anthropic. No project folder is required: Cowork plugins are uploaded directly into your Cowork workspace via the Customize panel.

What format does the Leopoldo Cowork package use?

Since v1.15 the Cowork package is a ZIP-of-ZIPs: one outer archive containing N .plugin files (one per plugin: leopoldo-core.plugin plus one per purchased domain) plus a README. Each .plugin is uploaded separately through the Cowork Customize panel.

Do I have to paste an activation key when installing on Cowork?

No. The activation key is embedded inside leopoldo-core.plugin (in the customer-specific leopoldo-client.json file). Cowork never prompts for the key during install. Keep the key from your welcome email for /leopoldo update and support reference.

Why upload leopoldo-core.plugin first?

Core carries the orchestrator, identity contract, brand profile, attribution, onboarding, and learning skills that every domain plugin references. If you upload a domain plugin first, it sits inert until core is installed. Order matters only for core; domain plugins among themselves can go in any order.

What happens after I finish installing all the .plugin files?

Open a new chat in Cowork and type /leo-onboard, or say 'Ciao Leo vorrei fare l'onboarding'. Leopoldo introduces itself, confirms the install, and walks you through a 5-minute setup (brand profile, language, first deliverable). If the slash command does not appear in autocomplete, refresh the Cowork page.

How do I update Leopoldo on Cowork?

Re-download the bundle from the same link in your welcome email (the link rebuilds from the latest source every time), extract, and re-upload each .plugin via Customize → + → Create plugin → Upload plugin. Cowork replaces the previous version in place. Or run /leopoldo update inside a chat to get the upgrade link automatically.