> ## Documentation Index
> Fetch the complete documentation index at: https://openworklabs.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Import a skill

> How to import an external skill into your workspace in OpenWork

There are currently two direct ways to import an external skill.

1. Create a skill with `Create skill in chat` and paste the external skill into that flow.
2. Install a shared skill from your OpenWork Cloud organization in `Skills -> Cloud` or `Settings -> Cloud`.

There is another option if you're technical: place it directly in `.opencode/skills/<skill-name>/SKILL.md` inside your workspace.

We recommend the built-in skill creator for one-off imports and OpenWork Cloud for team-managed skills.

For teams, OpenWork Cloud can publish shared skills either as standalone org skills or inside a marketplace plugin. Each desktop workspace can install them from the `Cloud` tab on the Skills page or from `Settings -> Extensions -> Marketplace`.

## Installing a skill from OpenWork Cloud

If someone on your team saved a skill to your active OpenWork Cloud organization, open either `Skills -> Cloud` or `Settings -> Cloud` in the desktop app.

From there you can:

* click `Install` to add the skill to the current workspace
* click `Sync` when the cloud version changes
* click `Uninstall` if you no longer want the workspace-managed copy

If the skill belongs to a hub, OpenWork also shows the hub name so you know where it came from.

## Creating a skill with `/skill-creator` in chat

Type `/skill-creator` in chat, then either paste the external skill you want to import or describe what you want the skill to do. OpenWork will generate a workspace-local skill from that input.

<Frame>
  <img src="https://mintcdn.com/differentai/kRSCNBy5OeKx9Ne1/images/skill-import-skill-creator-command.png?fit=max&auto=format&n=kRSCNBy5OeKx9Ne1&q=85&s=b01d26688145461b95029663b38676d3" alt="Using the /skill-creator command in chat" width="2036" height="1850" data-path="images/skill-import-skill-creator-command.png" />
</Frame>

When pasting an existing skill, the file should follow this structure:

```text theme={null}
---
name: name of the skill
description: one line description of what the skill does
---

Any markdown text with instructions and description of the skill
```

Make sure the file follows that format when importing skills from other marketplaces or other teams.
