skilo

A CLI tool for Agent Skills development.

Installation

# Quick install
curl -sSfL https://raw.githubusercontent.com/manuelmauro/skilo/main/install.sh | sh

# Or from crates.io
cargo install skilo

Quick Start

skilo new my-skill                    # Create a skill from template
skilo add owner/repo                  # Install skills from git
skilo remove my-skill                 # Remove a skill
skilo list                            # List installed skills
skilo lint .                          # Validate skills
skilo fmt .                           # Format SKILL.md files

Run skilo -h for all commands and options.

Using the Skilo Skill

Install the use-skilo skill to teach your AI assistant how to use skilo:

skilo add manuelmauro/skilo --skill use-skilo

Commands

Skill Structure

my-skill/
├── SKILL.md        # Required: manifest with YAML frontmatter
├── scripts/        # Optional: executable scripts
├── references/     # Optional: additional docs
└── assets/         # Optional: static resources

SKILL.md Format

---
name: my-skill
description: What the skill does and when to use it.
license: MIT
---

# My Skill

Instructions for the AI agent.

Configuration

Create .skilorc.toml for project settings:

[lint]
strict = true

[lint.rules]
name_format = true
name_length = 64
body_length = 500

[new]
default_license = "MIT"
default_template = "hello-world"

[add]
# default_agent = "claude"  # Optional: defaults to ./skills/
confirm = true

See skilo lint --help for all available rules.

Multi-Agent Support

Skilo supports 14 AI coding agents. By default, skills install to ./skills/. Use --agent to target specific agents:

skilo add owner/repo --agent claude           # Install to .claude/skills/
skilo add owner/repo --agent all              # Install to all detected agents
skilo new my-skill --global --agent claude    # Create global skill
skilo agents                                  # List detected agents

Environment Variables

Shell Completions

# Bash (add to ~/.bashrc)
eval "$(skilo self completions bash)"

# Zsh (add to ~/.zshrc)
eval "$(skilo self completions zsh)"

# Fish (add to ~/.config/fish/config.fish)
skilo self completions fish | source

CI Integration

- name: Validate skills
  run: |
    curl -sSfL https://raw.githubusercontent.com/manuelmauro/skilo/main/install.sh | sh
    skilo check --strict .

License

MIT OR Apache-2.0