Skip to content

inhere/skillc

Repository files navigation

Skillc

GitHub go.mod Go version GitHub tag (latest SemVer) Unit-Tests


English | 简体中文

skillc Single binary file, a local skills management tool for the multi-Agent ecosystem.

Features

  • 📦 Multi-source management — Local paths and Git repositories as Skill sources
  • 🔍 Index & search — Auto-scans sources and builds a searchable index
  • One-shot install--source flag registers, syncs, and installs in a single command
  • 🔒 Lock file tracking — Records origin, version, and install path; supports restore
  • 🤖 Multi-agent adapters — Automatically targets each agent's install directory
  • 🔄 Batch update — Update all installed Skills with one command

Installation

Install by eget

Can quickly install by inherelab/eget

eget install inhere/skillc

Install by Go

go install github.com/inhere/skillc/cmd/skillc@latest

Build from source

git clone https://github.com/inhere/skillc
cd skillc
make build          # compile to current directory
make install        # install to $GOPATH/bin

Quick Start

# 1. Initialize config
skillc config init

# 2. Add a Skill source (Git repo or local path)
skillc source add git https://github.com/org/skills.git
skillc source add local /path/to/my-skills

# 3. Sync sources (clone/pull and rebuild index)
skillc source sync --all

# 4. Search for a Skill
skillc search typescript

# 5. Install a Skill
skillc install my-skill

# 6. List installed Skills
skillc list

Command Reference

config — Configuration

skillc config init               # initialize config file
skillc config show               # display current config
skillc config set <key> <value>  # update a config value

source — Source management

skillc source list                    # list all sources
skillc source add git <url> [ref]     # add a Git source
skillc source add local <path>        # add a local source
skillc source sync <id>               # sync a source (partial ID match supported)
skillc source sync --all              # sync all sources
skillc source status                  # show source status
skillc source remove <id>             # remove a source

source sync supports partial ID matching — e.g. skillc source sync edge matches local-golang-edge-skills.

install — Install Skills

skillc install <skill-id>             # install a Skill
skillc install <id1>,<id2>            # install multiple (comma-separated)
skillc install --collection <name>    # install an entire Collection
skillc install                        # restore all Skills from lock file

# One-shot: register source → sync → install
skillc install --source https://github.com/org/skills.git my-skill
skillc install --source /path/to/local-skills my-skill

Options:

Flag Short Default Description
--scope -s project Install scope (project / global)
--agent -a claude-code Target agent name or directory
--yes -y false Skip confirmation prompt
--collection -c false Treat targets as Collection selectors
--source -S Git URL or local path — auto-register & sync before installing

update — Update Skills

skillc update                        # update all installed Skills
skillc update --target <skill-id>    # update a specific Skill

uninstall — Remove Skills

skillc uninstall <skill-id> [...]    # uninstall one or more Skills

list — Installed Skills

skillc list                          # list installed Skills (current agent)
skillc list --scope global           # list globally installed Skills

search / show — Index search

skillc search <keyword>              # keyword search
skillc search <keyword> --agent claude  # filter by agent
skillc show <skill-id>               # show Skill details

collection — Browse Collections

skillc collection list               # list all Collections
skillc collection skills <name>      # list Skills in a Collection

doctor — Environment check

skillc doctor                        # verify git, config, index, and cache

Configuration

Config file lookup order:

  1. ./skillc.yaml (current directory)
  2. ~/.config/skillc/config.yaml

Key fields:

lock_file: skillc.lock.yaml        # lock file path
index_file: skillc-index.json      # index file path
repo_cache_dir: ~/.cache/skillc    # Git repo cache directory
proxy_url: ""                      # HTTP proxy (optional)
sources: []                        # registered sources

Lock File

skillc.lock.yaml records every installed Skill and is used by skillc install (no args) to restore all Skills:

records:
  - skill_id: my-skill
    source_id: git-org-skills
    agent: claude-code
    scope: project
    installed_path: .claude/skills/my-skill
    installed_at: "2026-01-01T00:00:00Z"

Development

go test ./...    # run all tests
make build       # local build

License

MIT

About

Single binary file, a local Skill management tool for the multi-Agent ecosystem. 单二进制文件,面向多 Agent 生态的本地 Skill 管理工具

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors