Getting Started

Skani is a tool for managing agent skills across development environments. This guide will help you set up your environment and install your first skill.

Prerequisites

Before using Skani, your local environment needs to be prepared. Skani requires one of the following runtimes to be in your system path:

Bunv1.0+

Node.jsv18.0+

01Initialize a Project

Run the following command in your project directory to create a skani.json file. This file tracks your project's installed skills.

➜~npx skani init my-project

✔ Project initialized in ./my-project Created skani.json manifest

02Install a Skill

Install skills directly from GitHub by providing the full URL to the skill directory. Skills are cached globally at ~/.skani for fast re-installs across projects.

➜~npx skani install https://github.com/obra/superpowers/tree/main/skills/test-driven-development

Use --refresh to force re-download from GitHub.

03List Installed Skills

View all installed skills in your current environment.

➜~npx skani list

Introduction

CLI Commands →