Reproducible skills for every AI agent

Install

Install script

Downloads the right archive for your platform and verifies its checksum.

curl -sSfL https://raw.githubusercontent.com/glapsfun/gskill/main/scripts/install.sh | sh

Homebrew

macOS and Linux.

brew install glapsfun/tap/gskill

Go

Requires a Go toolchain.

go install github.com/glapsfun/gskill/cmd/gskill@latest

npm

Requires Node.js 20 or newer.

npm install --global @glapsfun/gskill

npx

Run without installing. Requires Node.js 20 or newer.

npx @glapsfun/gskill version

npx @glapsfun/gskill add github.com/glapsfun/gskill/examples/skills/hello-gskill --agent claude

Container

Linux images for amd64 and arm64. Requires Docker, Podman, or another container runtime.

docker run --rm ghcr.io/glapsfun/gskill:latest version

docker run --rm --user "$(id -u):$(id -g)" -e HOME=/tmp -v "$PWD:/workspace" -w /workspace ghcr.io/glapsfun/gskill:latest add github.com/glapsfun/gskill/examples/skills/hello-gskill --agent claude

Then check it with gskill version. For install locations and release verification, see Install GSKILL.

Add, commit, reproduce, verify

Terminal

# In your project's Git repository:
gskill add github.com/glapsfun/gskill/examples/skills/hello-gskill --agent claude
git add -A && git commit -m "Add hello-gskill"

# On a fresh clone, or after deleting the installed copy:
rm -rf .agents/skills .claude/skills
gskill install --frozen-lockfile
gskill project verify

The skill’s content lands in your repository next to skills-lock.json, so a fresh clone already has working skills. gskill install --frozen-lockfile restores exactly what the lockfile records, and gskill project verify re-hashes it to prove nothing changed.

Why GSKILL

Reproducible installs

skills-lock.json records what you asked for and what was resolved. --frozen-lockfile restores exactly, or fails closed.

Verified integrity

Every install is checked against a recorded content hash, and gskill project verify re-checks on demand. Skill content is never executed.

Many agents, one copy

A skill is resolved and stored once, then shared with every agent that targets it through symlinks, or copies where links are not supported.

Built for CI

Every capability is a CLI command with --json output and documented exit codes, so pipelines can gate on drift.

Supports Claude Code, Codex, Cursor, Antigravity CLI, OpenCode, OpenClaw, and Hermes Agent on Linux and macOS. See Supported agents.

Where to next

New here

What is GSKILL? then Getting started: add a skill, commit it, and reproduce it from the lockfile.

Know what you want

The how-to guides cover one task per page: adding skills, updating, working offline, and gating CI on drift.

Looking something up

Commands, exit codes, configuration, and the lockfile schema.

How it works

The reproducibility model, integrity and trust, and the clone cache.