askill

askill is a command-line Agent Skill Registry Manager designed to help you discover, install, update, and manage skills for AI agents. It simplifies the process of distributing and versioning skills across different projects and environments.

Features

• Multi-Source Support: Install skills from GitHub repositories, remote Git repositories, or local directories.
• Dependency Management: Uses an askill.lock file to track installed versions and ensure consistency.
• Target Aliases: Easily manage skills in different locations (e.g., project, global, or custom paths) using aliases.
• Interactive CLI: Search and select skills from remote registries directly in your terminal.
• Skill Validation: Built-in validation to ensure skills conform to the required structure and metadata.
• Scaffolding: Quickly initialize new skills with the init command.

Installation

To install askill from source, ensure you have Rust installed:

cargo install --path .

Quick Start

1. Initialize a Registry

Initialize the default project registry in your current directory:

askill init my-new-skill

2. Add Skills

Add skills from a GitHub repository:

# Interactively select skills from a repository
askill add github:user/repo
# Install all skills from a repository
askill add github:user/repo --all
# Install a specific skill to the global registry
askill add github:user/repo/skills/my-skill -t global

3. List Installed Skills

View skills installed in your current project:

askill list

4. Update Skills

Update installed skills to their latest versions:

askill update

5. Remove Skills

Remove a skill from your registry:

# Interactively select skills to remove
askill remove
# Force remove a specific skill
askill remove my-skill -f

Core Concepts

Registry

A directory containing a set of skills and an askill.lock file.

Skill

A directory containing a SKILL.md file with metadata and instructions.

Target Aliases

askill uses aliases to reference different registry locations:

• project: Defaults to ./.agents in your current directory.
• global: Defaults to ~/.agents (configurable).
• You can add custom aliases using askill alias add <name> <path>.

Documentation

For more detailed information, please refer to the docs/ directory:

• Core Concepts
• CLI Reference
• Architecture
• Examples

License

This project is licensed under the MIT License - see the LICENSE file for details.