Skip to main content

CLI Overview

The Auto-Skill CLI provides commands for initializing configuration, discovering patterns, managing skills, and viewing telemetry.

Installation

npm install -g @matrixy/auto-skill

Usage

auto-skill [command] [options]

Available Commands

init

Initialize auto-skill configuration and directories

discover

Discover patterns relevant to your current project

agents

List and detect installed coding agents

lock

Manage skill lock file and verify integrity

graduate

Promote skills from auto-generated to permanent

telemetry

View usage telemetry and effectiveness reports

Global Options

All commands support the following option:
--json
boolean
default:"false"
Output results in JSON format instead of human-readable text

Command Reference

auto-skill --help
auto-skill [command] [options]

Auto-Skill - Automatically learn and generate skills

Options:
  -V, --version              output the version number
  -h, --help                 display help for command

Commands:
  init [options]             Initialize auto-skill
  discover [options]         Discover skills for current project
  stats [options]            Show adoption statistics
  graduate [action]          Manage skill graduation
  agents [action]            Manage agent configurations
  lock [action]              Manage skill lock file
  telemetry [action]         View usage telemetry
  help [command]             display help for command

Version

auto-skill --version
# 4.0.1

Getting Started

1

Initialize Auto-Skill

auto-skill init
Creates configuration files and directories in ~/.claude/
2

Discover Patterns

cd your-project
auto-skill discover
Analyzes your project for skill opportunities
3

View Telemetry

auto-skill telemetry report
Check skill effectiveness and usage statistics
For skill search and installation, use the Skills CLI:
npx skills find [query]        # Search for skills
npx skills add owner/repo      # Install skills
npx skills list                # List installed skills

Next Steps

Initialize Configuration

Set up Auto-Skill for the first time

Discover Patterns

Find skills relevant to your project

Build docs developers (and LLMs) love