Skip to main content
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

1

Open Skills settings

Go to Settings → Skills.
2

Go to the GitHub Import tab

Click the GitHub Import tab.
3

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)
4

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.
5

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:
  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.
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.