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

# Import a Skill from GitHub

> Import skill configurations directly from a GitHub repository — useful for team sharing and community skills.

ZeroTwo can import skill configurations directly from a GitHub repository. This makes it easy to share skills with your team by hosting the configuration in a shared repo, or to import community-built skills from public repositories.

## Use Cases

* **Team sharing** — host your organization's custom skills in a private GitHub repo so all team members can import from the same URL
* **Community skills** — import useful skills built and shared by the ZeroTwo community via public GitHub repos
* **Version control** — manage skill configurations as code, with proper versioning and change history

## Steps to Import

<Steps>
  <Step title="Open Skills settings">
    Go to **Settings → Skills**.
  </Step>

  <Step title="Go to the GitHub Import tab">
    Click the **GitHub Import** tab.
  </Step>

  <Step title="Enter the repository URL">
    Paste the full GitHub repository URL. The repo must be:

    * **Public**, or
    * **Private, but you have access** (you must be logged in via GitHub OAuth or the repo must be accessible to your account)
  </Step>

  <Step title="ZeroTwo parses the skill configuration">
    ZeroTwo reads the skill configuration file from the repository (`skill.json` or compatible format) and shows you a preview of the skill details: name, trigger, description, tools, and model.
  </Step>

  <Step title="Review and import">
    Review the skill details in the preview pane. If everything looks correct, click **Import**.
  </Step>
</Steps>

The imported skill is saved to your custom skills and immediately available via `@trigger` in all your chats.

## Skill Configuration File Format

A skill configuration file in a GitHub repo should follow this structure:

```json theme={null}
{
  "name": "Summarize",
  "trigger": "summarize",
  "description": "Summarizes text into 3-5 bullet points focused on key facts.",
  "system_prompt": "Summarize the provided text in 3-5 bullet points. Focus on key facts and main ideas. Start bullets with action verbs where possible. Return only the bullet list.",
  "model": "default",
  "tools": {
    "web_search": false,
    "canvas": false,
    "deep_research": false
  }
}
```

The file should be named `skill.json` and placed in the root of the repository (or a `/skills` directory if the repo contains multiple skills).

## Multi-Skill Repositories

A single GitHub repo can contain multiple skill configuration files. If ZeroTwo detects multiple skills in a repo, it shows each one individually in the preview — you can select which ones to import.

```
/skills
  ├── summarize.json
  ├── translate.json
  ├── code-review.json
  └── extract-action-items.json
```

## Updating Imported Skills

ZeroTwo doesn't automatically sync imported skills with their source repositories. If the source repo is updated:

1. Go to **Settings → Skills → Custom** (or GitHub import tab)
2. Find the imported skill
3. Re-import from the same URL to pull the latest version

The re-imported version replaces the existing one.

## Team Sharing

To share skills with your team using GitHub:

1. Create a GitHub repository (private if the skill contains proprietary instructions)
2. Add skill configuration files following the format above
3. Share the repository URL with your team
4. Each team member goes to **Settings → Skills → GitHub Import** and imports from the URL

This ensures everyone is using the same skill configuration and can benefit from updates centrally managed in the repo.

<Tip>
  If you host skills for your team on GitHub, include a README in the repo describing each skill, its intended use, and example invocations. This makes it easier for team members to know which skill to use.
</Tip>