[Docs index](/docs.md) / [Agent Skills](/docs/agent-skills/overview.md) / Importing a Team AI Workflow Skill

---

# Importing a Team AI Workflow Skill

This guide walks through importing an Agent Skill from a supported source so your team can review, rename, and adapt it before using it in Assist.

Import is useful when a workflow already exists outside Assist: a repository, a shared prompt pack, or a skill someone found in a marketplace. Imported skills are drafts, so they can be cleaned up before approval.

## Before you begin

- You need the source URL or command for the skill.
- The source must contain a `SKILL.md` file.
- The imported files must fit within the skill file and size limits.
- Imported skills are drafts. Review them before approval and rollout.

## Steps

### 1. Open Skills

Open **Skills** from the main navigation.

### 2. Start creating a skill

Click **Create Skill**.

### 3. Switch to Import

Select the **Import** tab. Assist shows an import form and explains that imported skills are installed as drafts.

![Import Agent Skill dialog](screenshots/agent-skills-import-dialog.png)

### 4. Paste the source

Paste one of the supported source formats into **Source**:

- A Skills Marketplace URL.
- A GitHub repository URL.
- A GitHub folder URL.
- An `owner/repo` shorthand.
- A `skills add owner/repo` command.

Assist loads the repository tree, finds the skill directory, and imports supported text files.

### 5. Rename for your company

Use **Name override** or **Slug override** when the imported name is too generic or too technical. Choose a name that maps to the workflow your team wants to standardize.

For example, rename "Prompt Library Cleanup" to "Team AI Usage Cleanup" if the skill will help a mid-sized company collect and review scattered prompts before moving them into Assist.

### 6. Choose the scope

Select **Workspace** for shared workflows. Select **Personal** if you are evaluating the imported workflow before proposing it to the team.

### 7. Import the workflow

Click **Import**. Assist creates a draft Agent Skill and opens the detail page.

### 8. Review every file

Open **Files** and inspect `SKILL.md` plus supporting files. Check for:

- References to tools or systems your workspace does not use.
- Customer data handling rules that do not match your policies.
- Missing review steps for customer-facing or sensitive work.
- Instructions that assume the agent can take actions it cannot actually take.
- Prompt examples that include private customer, employee, or company data.

### 9. Submit for approval

When the draft matches your operating model, submit it for review. Imported skills should not be attached to live agents until a workflow owner or admin approves them.

## Next steps

- [Authoring and Approving Agent Skills](authoring-and-approving-agent-skills.md)
- [Governing Agent Skill Versions](governing-agent-skill-versions.md)
- [Troubleshooting](troubleshooting.md)

---

## Navigation

### In this section: Agent Skills

- [Agent Skills](/docs/agent-skills/overview.md)
- [Use Cases and Playbooks](/docs/agent-skills/use-cases.md)
- [Troubleshooting Agent Skills](/docs/agent-skills/troubleshooting.md)
- [Attaching Agent Skills to Operational Agents](/docs/agent-skills/attaching-skills-to-operational-agents.md)
- [Authoring and Approving Agent Skills](/docs/agent-skills/authoring-and-approving-agent-skills.md)
- [Creating a Managed AI Workflow Skill](/docs/agent-skills/creating-a-managed-ai-workflow-skill.md)
- [Governing Agent Skill Versions](/docs/agent-skills/governing-agent-skill-versions.md)
- **Importing a Team AI Workflow Skill** (current)

#### Playbooks

- [Playbook: Build a Department AI Rollout Skill](/docs/agent-skills/playbook-department-ai-rollout.md)
- [Playbook: Build a Team AI Usage Cleanup Skill](/docs/agent-skills/playbook-ai-usage-inventory.md)
- [Playbook: Build a Team Prompt Standardization Skill](/docs/agent-skills/playbook-prompt-standardization.md)

### Other sections

- [MCP Servers](/docs/mcp-servers/overview.md)
- [Tool Creation](/docs/tool-creation/overview.md)
- [Agent Filesystem](/docs/agent-filesystem/overview.md)
- [Chat Sharing](/docs/chat-sharing/overview.md)
- [Scheduled Triggers](/docs/scheduled-triggers/overview.md)
- [Sandcastles](/docs/sandcastles/overview.md)
- [Subagents](/docs/subagents/overview.md)
- [Workspace Permissions](/docs/workspace-permissions/overview.md)

[Back to docs index](/docs.md)