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

# Skills

> Save and reuse skills in Windmill so every conversation with Windy starts with the right context.

Skills let you save instructions you use often and reuse them in any conversation with Windy. Instead of retyping the same context every time, you can select a saved skill and Windy will use it as context for your message.

Skills can be kept private, shared with specific teammates or groups, or, if you're an HR Admin, shared with managers or everyone at your company. Windmill also curates a set of **Global** skills available to all customers for common workflows like writing review feedback, preparing for 1:1s, or summarizing team updates.

## Using a skill

You can browse and select skills from a few places in the chat:

* **Slash icon** - Click the slash icon in the chat input bar to open your recent skills.
* **Type "/"** - Type `/` in the chat input to open a quick-access dropdown with your recent and searched skills. Select **Browse skills** at the bottom to open the full picker.
* **Browse skills** - Click **Browse skills** in the recent skills section above the chat input.

When you select a skill, it appears as a reference chip in your chat input. Send your message and Windy will use that skill as context for the conversation. You can select multiple skills in a single message.

### Browsing skills

The **Browse Skills** dialog shows every skill you have access to: ones you created, ones shared with you, ones shared company-wide, and Global skills. Use the search bar to find a skill by name, or use the quick filters to narrow by **All**, **Shared with me**, or **Created by me**.

If you need to edit or share a skill, click **Manage Skills** to jump to the Skills settings page.

## Creating a skill

All skill management lives in Settings > Skills. This is where you create, edit, share, duplicate, and delete your skills.

<Steps>
  <Step title="Go to Settings > Skills">
    Navigate to [Settings > Skills](https://app.gowindmill.com/COMPANY/config/skills) in the Windmill Dashboard.
  </Step>

  <Step title="Click Create Skill">
    Click the **Create Skill** button. Windmill opens a new blank skill page.
  </Step>

  <Step title="Add the skill details">
    Add the name and skill body on the detail page.
  </Step>

  <Step title="Click Publish">
    Publish the skill when you're ready. Windmill opens the sharing dialog so you can choose who can access it.
  </Step>
</Steps>

<Tip>
  You can chat with Windy before creating a skill to help turn your rough idea into clearer, more powerful skill instructions.
</Tip>

## Sharing a skill

Every skill is private to you when you create it. To share it with someone else, open the skill and click **Share**.

The share dialog works much like Google Docs or Notion. You can add:

* **Individuals** - share with specific teammates by name
* **Groups** - share with any employee group in Windmill, such as Engineering or People Ops
* **My team** - if you manage people, share with everyone who reports to you, directly or indirectly

For each entry, choose whether they get **View** or **Edit** access:

* **View** - can use the skill in chat and duplicate it, but can't edit or re-share it
* **Edit** - can edit the title and body, change sharing, or delete it

Click **Save** to apply changes. Sharing takes effect immediately.

<Tip>
  Group and team shares are dynamic. If a new person joins a group or starts reporting to you, they'll automatically get access. You don't need to re-share the skill.
</Tip>

### Sharing with managers or everyone

HR Admins and Admins can use **General access** in the share dialog to share a skill more broadly:

* **Managers** - all managers at your company can view and use the skill
* **Everyone** - everyone at your company can view and use the skill

When General access is set:

* Only HR Admins, Admins, and the creator can edit it
* People with **Edit** access from a direct share or group share can also edit it

Members and Managers don't see the General access option. They can only share with specific individuals, groups, or their own team, if they manage people.

## Duplicating a skill

If an existing skill is close to what you need but you want your own version, you can duplicate it. From the skill detail page, click the menu and select **Duplicate**.

The duplicate is private to you and fully editable, regardless of your access level on the original. The original skill stays unchanged.

You can duplicate any skill you have access to, including personal, shared, company-wide, or Global skills.

## Managing your skills

From Settings > Skills, you can:

* **Edit** any skill you have edit access to
* **Share** or update sharing on skills you have edit access to
* **Rename** skills you have edit access to
* **Duplicate** any skill you can access
* **Delete** skills you have edit access to

Use search to find a skill by name, or use filters to narrow the list by **Created by** or **General access**. General access filters include **Company** and **Managers**.

### Deleting skills

Deleting removes a skill from the gallery and chat. To delete a skill, open it and select **Delete skill** from the menu. You'll be asked to confirm before it's deleted.

You can't currently restore a deleted skill from Settings > Skills. Deleting a skill won't break past conversations where the skill was used.

## FAQs

<AccordionGroup>
  <Accordion title="Who can see a skill I create?">
    Only you, until you share it. When you create a skill, it's private to you. Use the **Share** button on the skill detail page to grant access to individuals, groups, your team, managers, or everyone at your company, depending on your role and permissions.
  </Accordion>

  <Accordion title="Who can share a skill with the whole company?">
    Only HR Admins and Admins can share a skill using **General access > Everyone**. Anyone with edit access can share with specific individuals or groups. Skill owners who manage people can also share with their own team.
  </Accordion>

  <Accordion title="What happens if I have View access via my team and Edit access from a direct share?">
    The most permissive permission wins. If any path grants you Edit access, you can edit the skill.
  </Accordion>

  <Accordion title="Can I edit a skill directly from the chat?">
    No. To keep skills consistent across your team, all editing happens in Settings > Skills. The **Manage Skills** link in the Browse Skills dialog will take you there in one click.
  </Accordion>

  <Accordion title="What happens to a skill if the person who created it leaves the company?">
    The skill stays available to everyone it was shared with. Anyone with edit access can continue updating it.
  </Accordion>

  <Accordion title="Can I delete a skill permanently?">
    Deleting a skill removes it from the gallery and chat. You can't currently restore a deleted skill from Settings > Skills.
  </Accordion>

  <Accordion title="Can I use more than one skill at a time?">
    Yes. You can select multiple skills as references in a single message.
  </Accordion>
</AccordionGroup>