https://github.com/inhere/skillc
Single binary file, a local Skill management tool for the multi-Agent ecosystem. 单二进制文件，面向多 Agent 生态的本地 Skill 管理工具
https://github.com/inhere/skillc
Last synced: 2 months ago
JSON representation
Single binary file, a local Skill management tool for the multi-Agent ecosystem. 单二进制文件，面向多 Agent 生态的本地 Skill 管理工具
- Host: GitHub
- URL: https://github.com/inhere/skillc
- Owner: inhere
- Created: 2026-04-20T06:40:37.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-24T07:38:17.000Z (2 months ago)
- Last Synced: 2026-04-24T18:32:14.257Z (2 months ago)
- Language: Go
- Size: 322 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Skillc
[](https://github.com/inhere/skillc)
[](https://github.com/inhere/skillc)
---
[English](./README.md) | [简体中文](./README.zh-CN.md)
`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](https://github.com/inherelab/eget)
```bash
eget install inhere/skillc
```
**Install by Go**
```bash
go install github.com/inhere/skillc/cmd/skillc@latest
```
**Build from source**
```bash
git clone https://github.com/inhere/skillc
cd skillc
make build # compile to current directory
make install # install to $GOPATH/bin
```
## Quick Start
```bash
# 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
```bash
skillc config init # initialize config file
skillc config show # display current config
skillc config set # update a config value
```
### `source` — Source management
```bash
skillc source list # list all sources
skillc source add git [ref] # add a Git source
skillc source add local # add a local source
skillc source sync # sync a source (partial ID match supported)
skillc source sync --all # sync all sources
skillc source status # show source status
skillc source remove # remove a source
```
> `source sync` supports **partial ID matching** — e.g. `skillc source sync edge` matches `local-golang-edge-skills`.
### `install` — Install Skills
```bash
skillc install # install a Skill
skillc install , # install multiple (comma-separated)
skillc install --collection # 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
```bash
skillc update # update all installed Skills
skillc update --target # update a specific Skill
```
### `uninstall` — Remove Skills
```bash
skillc uninstall [...] # uninstall one or more Skills
```
### `list` — Installed Skills
```bash
skillc list # list installed Skills (current agent)
skillc list --scope global # list globally installed Skills
```
### `search` / `show` — Index search
```bash
skillc search # keyword search
skillc search --agent claude # filter by agent
skillc show # show Skill details
```
### `collection` — Browse Collections
```bash
skillc collection list # list all Collections
skillc collection skills # list Skills in a Collection
```
### `doctor` — Environment check
```bash
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:
```yaml
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:
```yaml
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
```bash
go test ./... # run all tests
make build # local build
```
## License
MIT