pixi-skills

Manage and install coding agent skills across multiple LLM backends using pixi.

pixi-skills discovers skills packaged in pixi environments and lets you install them into the configuration directories of various coding agents via symlinks.

For more background on why distributing agent skills through package managers makes sense, check out the blog post Managing Agent Skills with Your Package Manager.

Installation

pixi global install pixi-skills
# or use without installing
pixi exec pixi-skills

Concepts

Skills

A skill is a directory containing a SKILL.md file with YAML frontmatter:

---
name: my-skill
description: "Does something useful for the agent"
---

Skill instructions go here as Markdown.
The agent reads this file to understand what the skill does.

The name field is optional and defaults to the directory name. The description field is required.

A collection of ready-to-use skills is available at skill-forge (source).

Scopes

• Local skills are discovered from the current project's pixi environment at .pixi/envs/<env>/share/agent-skills/.
• Global skills are discovered from globally installed pixi packages at ~/.pixi/envs/*/share/agent-skills/.

If multiple global environments provide a skill with the same name, pixi-skills shows the environment name in parentheses and lets you install one source at a time.

Supported backends

Skills are installed as relative symlinks for portability.

The agents backend links skills into the .agents/skills/ directory that many agents read. The cline and codex backends use the same directory. Earlier versions installed Codex skills into .codex/skills/, which Codex no longer reads. Remove those symlinks and reinstall the skills with pixi-skills manage --backend codex.

Usage

List available skills

# List all local and global skills
pixi-skills list

# List only local skills
pixi-skills list --scope local

# List skills from a specific pixi environment
pixi-skills list --env myenv

Manage skills interactively

# Interactive mode - prompts for backend and scope
pixi-skills manage

# Specify backend and scope directly
pixi-skills manage --backend claude --scope local

This opens an interactive checkbox selector where you can choose which skills to install or uninstall.

Show installed skills

# Show installed skills across all backends
pixi-skills status

# Show installed skills for a specific backend
pixi-skills status --backend claude

Development

This project is managed by pixi.

git clone https://github.com/pavelzw/pixi-skills
cd pixi-skills

pixi run pre-commit-install
pixi run test