Getting started

Requirements

• Node.js 20 or newer
• For GitHub Sources: the gh CLI, authenticated (gh auth login or GH_TOKEN)

Install

# One-off (recommended to try)
npx @zortracks/skli --help

# Global install
npm install -g @zortracks/skli
skli --help

First project

cd your-project
npx @zortracks/skli init

This creates {project}/.skli/skli.json and registers the project in ~/.skli/projects.json.

Typical workflows

Reference a local package

Use when the skill/rule/agent already lives in the repo and you only need it listed in the manifest:

npx @zortracks/skli add cursor rule .cursor/rules/my-rule.mdc

Install from GitHub

Copies the package into IDE folders and records a repos entry:

npx @zortracks/skli install cursor skill owner/repo@v1:skills/foo
npx @zortracks/skli install cursor,claude skill owner/repo:skills/foo --gitignore

Link a remote manifest

Pulls .skli/skli.json from another GitHub repo and lets you select which packages to deploy (stored under links, not as local Package map entries):

npx @zortracks/skli link cursor owner/repo
npx @zortracks/skli link cursor owner/repo --all --gitignore

Keep packages current

npx @zortracks/skli update --all
npx @zortracks/skli restore --all          # re-fetch pinned versions
npx @zortracks/skli remove cursor skill foo
npx @zortracks/skli unlink owner/repo

Next steps

• Concepts — Package, Manifest, Link, Scope
• Configuration — file locations
• Commands — full CLI reference