Installation

Prerequisites

skillshub is built with Rust. Before installing, make sure you have the Rust toolchain available on your system.

If you do not already have Rust and Cargo installed, use rustup to set them up:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

After installation, ensure cargo is on your PATH by restarting your shell or running:

source "$HOME/.cargo/env"

You can verify the toolchain is ready with:

cargo --version

Installing via Cargo

The fastest way to install skillshub is directly from crates.io using Cargo:

cargo install skillshub

This downloads the latest published release, compiles it, and places the binary in ~/.cargo/bin/. As long as that directory is on your PATH, you are good to go.

Verifying the Installation

Confirm that skillshub was installed correctly:

skillshub --version

You should see output similar to:

skillshub 0.1.0

Building from Source

If you want the latest development version or need to make modifications, you can build skillshub from its source repository.

Clone the Repository

git clone https://github.com/EYH0602/skillshub.git
cd skillshub

Build a Release Binary

cargo build --release

The compiled binary will be located at target/release/skillshub. You can copy it to a directory on your PATH:

cp target/release/skillshub ~/.cargo/bin/

Running Tests

To make sure everything works on your system, run the test suite before installing:

cargo test

Shell Completions

skillshub can generate tab-completion scripts for your shell. This gives you autocompletion for commands, flags, and installed skill names.

Bash

skillshub completions bash > ~/.local/share/bash-completion/completions/skillshub

Zsh

skillshub completions zsh > ~/.local/share/zsh/site-functions/_skillshub

Make sure the directory is listed in your fpath. You can add the following to your ~/.zshrc if it is not already present:

fpath=(~/.local/share/zsh/site-functions $fpath)
autoload -Uz compinit && compinit

Fish

skillshub completions fish > ~/.config/fish/completions/skillshub.fish

After generating the completion file for your shell, open a new terminal session or reload your shell configuration for the completions to take effect.