Repositories
Managing skill repositories
What Are Repositories?
OpenSkill uses Git repositories as the source for skills. A repository is a Git repo containing one or more skill directories, each with a SKILL.md file.
You can use repositories from GitHub, GitLab, self-hosted Git servers, or any accessible Git URL.
Adding Repositories
terminal
# From GitHub
$ osk repo add https://github.com/username/skills
# With custom name
$ osk repo add https://github.com/username/skills my-skills
# From GitLab
$ osk repo add https://gitlab.com/username/skills
# SSH
$ osk repo add git@git.company.com:team/skills.gitURL Formats
OpenSkill accepts various Git URL formats:
| Format | Example |
|---|---|
| GitHub HTTPS | https://github.com/user/repo |
| GitHub SSH | git@github.com:user/repo.git |
| GitLab HTTPS | https://gitlab.com/user/repo |
| Generic HTTPS | https://git.example.com/repo.git |
| With branch | https://github.com/user/repo#branch |
| Skill path | https://github.com/user/repo/tree/main/skills/name |
Syncing
Update all repositories to their latest versions:
terminal
$ osk repo sync
# Sync a specific repository
$ osk repo sync my-skillsRepositories are cloned to
~/.openskill/repos/<repo-name>/ and configuration is stored in ~/.openskill/config.json.Managing Repositories
terminal
# List repositories
$ osk repo ls
# Get repository details
$ osk repo info my-skills
# Remove a repository
$ osk repo rm my-skills