Installation

The Skillz CLI is the primary tool for managing your AI skills and dependencies.

Automated Install (Linux/macOS)

The easiest way to install Skillz is using the installation script.

curl -fsSL https://raw.githubusercontent.com/tnfssc/skillz/refs/heads/develop/install.sh | sh

From Source

If you have Go installed, you can install directly from the source.

go install github.com/tnfssc/skillz/cli/cmd/skillz@latest

Prerequisites

Go 1.24.1 or higher (for source install)
Git (for downloading dependencies)

Commands

Reference guide for the available CLI commands.

skillz init

Initialize a new Skillz project in the current directory. Creates a skillz.toon manifest and a SKILL.md template.

skillz add <name|git-url>

Add a skill dependency. Supports registry packages or Git URLs.

Usage:

skillz add browser-use
skillz add https://github.com/user/repo.git
skillz add -D my-dev-skill

skillz install

Install all dependencies defined in skillz.toon. Generates skillz.lock.

skillz login

Authenticate with the registry using an API token.

Usage:

skillz login --token <your-token>
# or interactive mode:
skillz login

skillz publish

Publish the current package to the registry. Requires authentication.

skillz list

List all installed skills and their versions.

skillz search <query>

Search the registry for skills.

skillz info <name>

Show detailed information about a skill.

skillz remove <name>

Remove a skill dependency from skillz.toon.

Configuration

The CLI can be configured via environment variables.

Variable	Description	Default
SKILLZ_REGISTRY_URL	URL of the Skillz registry API	https://api.skillz.lat

Manifest Format

Skillz uses the TOON format for configuration in skillz.toon.

manifest-version: 1
name: my-agent
version: 1.0.0
description: A helpful AI agent
author: Jane Doe
license: MIT

skill:
  main: SKILL.md
  requires:
    - python
  exports:
    - analyze

dependencies:
  skills:
    # Registry dependency
    browser-use: ^1.0.0

    # Git dependency
    git-helper:
      git: https://github.com/user/git-helper.git
      ref: main

dev-dependencies:
  skills:
    test-runner: ^0.5.0

scripts:
  test: skillz run test-runner
  start: python agent.py

constraints:
  os:
    - linux
    - darwin