Import a Skill from GitHub

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

Open Skills settings

Go to Settings → Skills.

Go to the GitHub Import tab

Click the GitHub Import tab.

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)

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.

Review and import

Review the skill details in the preview pane. If everything looks correct, click Import.

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:

{
  "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:

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

The re-imported version replaces the existing one. To share skills with your team using GitHub:

Create a GitHub repository (private if the skill contains proprietary instructions)
Add skill configuration files following the format above
Share the repository URL with your team
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.

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.

​Use Cases

​Steps to Import

​Skill Configuration File Format

​Multi-Skill Repositories

​Updating Imported Skills

​Team Sharing

Use Cases

Steps to Import

Skill Configuration File Format

Multi-Skill Repositories

Updating Imported Skills

Team Sharing