Using Merlin
Shared skills
Discover, publish, create and install reusable instructions for your team.
Skills package reusable instructions and supporting files. Merlin supports skills discovered on a member's machine and skills authored in the workspace catalog.
Discover local skills
Open Agent, select your device and open Skills. Merlin reports supported user-level skills from the agent environment, including their descriptions, availability and compatible runtimes.
The inventory covers supported user-global locations such as ~/.claude/skills and ~/.agents/skills. A skill stored only inside a project or repository is not part of the runtime inventory.
Share a skill from your machine
The skill owner can change a discovered local skill to public. Its source machine must be online so Merlin can validate and publish the bundle.
A successful publication appears under Shared by members in the workspace catalog. Teammates can inspect the published files and install the package on eligible runtimes. Continue editing the original local files, then use Publish local changes to update the published bundle.
If validation or publication fails, the existing published version remains. Fix the source or connection before retrying.
The source owner can make the skill private again. Owners and admins can also remove a member-shared publication from the catalog. This does not delete the source files or stop an already authorized public runtime from using its local copy.
Create a workspace-managed skill
In Skills, open Managed by workspace and choose Add skill. Every registered member can create a new draft or import a supported ZIP package.
Before first publication, the draft is visible only to its creator. Add a clear name and description, edit the package files, then publish when it is ready for teammates.
Published updates use the same edit, review and publish flow. The installation name is fixed after first publication. If an edit conflicts with a newer change, reload or review the current version before continuing.
Install a published skill
Open a published skill, inspect its files and choose Install skill. Select the eligible target runtimes shown by the web app.
A published skill shows its source, owner and every file Merlin will read. Review SKILL.md before installing it on a runtime.
Each target is one runtime on one of your devices and receives its own copy in that provider's skills folder. Installed copies stay private and do not update themselves when the published skill changes.
Publishing adds the package to the catalog. Installing copies it to the chosen local agents. It is not installed automatically across every machine.
The skill creator maintains its content. Owners and admins can govern published workspace skills by archiving or deleting them, but they cannot read or edit another person's unpublished draft.
Skills and runtime access
A skill's catalog access controls publication and distribution, not runtime execution. An authorized request on a public runtime may use the enabled skills already present there.
Use Custom instructions for one task or lasting preferences. Use a skill when teammates need a repeatable workflow and supporting files.