Trivium

Install and manage Agent Skills from Git repositories.

trivium pins installed skills to exact Git commits, records their state in a lockfile, and lets you save and switch between named skill environments. It manages skill directories on disk without coupling your setup to a specific agent runtime or framework.

Why trivium?

• Pinned Git sources: Install skills from exact commits for predictable, reproducible setups.
• Lockfile tracking: Record installed skills and their source metadata in skills.lock.
• Project-local or global installs: Manage skills for one project or for your user account.
• Safe updates: Preview add and update operations with dry runs.
• Named environments: Save and switch between repeatable skill configurations.
• Filesystem safety: Validate lockfiles, block unsafe paths, and use atomic writes.

Install

Install trivium with uv:

uv tool install skill-trivium

Or run it without installing:

uvx --from skill-trivium trv --help

Quick start

From the root of your project, install every skill from a Git repository:

trv add https://github.com/example/skills.git --all

Install selected skills:

trv add https://github.com/example/skills.git \
  --skills pdf-processing algorithmic-art

Inspect the current installation:

trv list
trv info skill-name

Preview and apply updates:

trv update --dry-run
trv update

Save and switch between named skill environments:

trv env create focused-work
trv env list
trv env activate focused-work

By default, project-local skills are installed under .agents/skills/ and recorded in skills.lock at the project root.

Commit skills.lock to version control when you want collaborators and CI environments to reproduce the same skill configuration.

Use --global to manage user-wide skills under ~/.agents/skills/.

Target a different agent directory with --dir, and move an existing install with trv move:

trv add https://github.com/example/skills.git --all --dir .claude
trv move .cursor

The choice is recorded in skills.lock, so later commands reuse it without the flag. Set TRIVIUM_AGENT_DIR to change the default for new installs.

Remove individual skills or clear the installation:

trv remove skill-name
trv remove --all --yes

Documentation

Full documentation is available at alapinenjoyer.github.io/trivium.

It covers installation, commands, named environments, the lockfile format, and filesystem safety guarantees.

Development

uv sync
make test

The project requires Python 3.13 or later.

Contributions and bug reports are welcome through GitHub Issues.