> ## Documentation Index
> Fetch the complete documentation index at: https://extended-openai-conversation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Discover Skills

> Browse, download, and install skills for your AI assistant

<Warning>
  Only install skills from trusted sources—ideally ones you created yourself or from the official repository. Skills can execute bash commands, read/write files, and make network requests. A malicious skill could lead to data exfiltration, unauthorized system access, or other security risks.
</Warning>

## Available Skills

<CardGroup cols={2}>
  <Card title="Browse Skills" icon="github" href="https://github.com/jekalmin/extended_openai_conversation/tree/develop/examples/skills">
    Browse skills in the GitHub repository
  </Card>

  <Card title="Create Your Own" icon="hammer" href="/skills/creating-skills">
    Learn to build custom skills
  </Card>
</CardGroup>

## Installing Skills

<Tabs>
  <Tab title="Download from Repository (Recommended)">
    Use the service to automatically download skills:

    ```yaml theme={null}
    service: extended_openai_conversation.download_skill
    data:
      skill_name: crypto
    ```

    <AccordionGroup>
      <Accordion title="What this does">
        * Downloads the skill from GitHub repository
        * Saves to `<config>/extended_openai_conversation/skills/`
        * Automatically reloads all skills
        * Returns list of downloaded files
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Manual Installation">
    <Steps>
      <Step title="Copy skill directory">
        ```bash theme={null}
        cp -r skill_name /config/extended_openai_conversation/skills/
        ```
      </Step>

      <Step title="Make scripts executable (if needed)">
        ```bash theme={null}
        chmod +x /config/extended_openai_conversation/skills/*/scripts/*.py
        ```
      </Step>

      <Step title="Reload skills">
        ```yaml theme={null}
        service: extended_openai_conversation.reload_skills
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Managing Skills

### Reload Skills

After manually creating or modifying skills:

```yaml theme={null}
service: extended_openai_conversation.reload_skills
```

**When to reload:**

* After manually creating a new skill
* After editing `SKILL.md` files
* After modifying skill metadata

<Info>
  You don't need to reload after using `download_skill` service—it reloads automatically.
</Info>

## Security Considerations

**Before installing any skill, audit it thoroughly:**

* **Review all files**: Check `SKILL.md`, scripts under `scripts/`, and any other bundled files. Look for unexpected network calls, unusual file access patterns, or operations that don't match the skill's stated purpose.
* **Be cautious with external sources**: Skills that fetch data from external URLs carry additional risk—even a trustworthy skill can be compromised if its external dependencies change over time.
* **Watch for tool misuse**: Skills can invoke HA services, run bash commands, and access the filesystem. Verify that a skill only uses the capabilities it claims to need.
* **Treat it like installing software**: Apply the same caution you would when installing any program on your system, especially for skills that have access to sensitive data or critical automations.