ski

Managing AI agent skills across tools is still manual, duplicated, and hard to reproduce.

Teams copy skill folders into .claude/skills, .codex/skills, and other agent directories by hand, then lose track of which repo, tag, or commit each project is actually using.

ski turns that into a package-manager workflow for agent skills. Install skills from Git into Claude, Codex, Cursor, and OpenClaw with a manifest, lockfile, and shared store.

---

Status

• git repositories as skill sources
• local and global scope
• init, add, install, remove, update, list, and doctor

---

Limitations

• Git-only sources
• Trust is manual
• No Windows support

---

Install

curl -fsSL https://raw.githubusercontent.com/Z-Bra0/Ski/master/scripts/install.sh | sh

---

Quick Start

ski init --target claude
ski add https://github.com/org/repo-map.git

ski add is the first-time workflow: it updates ski.toml, resolves and writes ski.lock.json, fetches the skill into the store, and links it into the configured targets.

Use ski install later to restore skills from ski.toml and ski.lock.json, for example in a fresh clone.

---

Examples

Share one repo-map skill across Claude and Codex:

ski init --target claude --target codex
ski add https://github.com/org/repo-map.git

This keeps one stored copy of the skill and links it into both .claude/skills and .codex/skills.

Pin a team audit skill to a specific commit:

ski init --target claude
ski add git:https://github.com/acme/team-audit-skill.git@9f3c2ab

This makes the project reproducible because the manifest and lockfile keep the selected source and resolved revision explicit.

Restore skills from the manifest and lockfile in a fresh clone:

ski install

---

Build

make build                     # local dev build; `ski version` prints `dev`
make release VERSION=0.1.1

---

Test

make test

---

Commands

ski init [-g]
ski add [-g] <source>
ski install [-g]
ski list [-g]
ski doctor [-g]
ski update [-g] [skill]
ski remove [-g] <skill>
ski version

---

Usage Notes

• Use ski only with skill repositories you have verified and trust. Review the upstream repo and SKILL.md before add, install, or update.
• ski add prompts when a repo contains multiple skills. In non-interactive mode, use --skill or --all.
• Supported sources are remote Git endpoints. You can use git:https://... or omit the git: prefix for URL-form sources such as https://..., ssh://..., and git://....
• ski version reports the CLI build version. Dev builds print dev; release builds use the version passed to make release VERSION=....
• make release VERSION=... also writes dist/ski_<version>_checksums.txt for installer verification.
• Local targets write into the project. -g uses ~/.ski/global.toml and global agent directories instead.
• Custom target folders use dir:. For example: dir:./agent-skills/claude.

---

Docs

• SPEC.md — file formats, schemas, adapter interfaces
• ARCHITECTURE.md — internal design and Go layout
• DECISIONS.md — design decisions and rationale

---

Author

Z-Bra

---

License

GPL-3.0. See LICENSE.