Pixi Skills
pixi-skills manages and installs coding agent skills across multiple LLM backends.
It discovers skills packaged in pixi environments and installs them into the configuration directories of various coding agents via symlinks.
For a detailed explanation of the motivation and design behind pixi-skills, see the blog post Managing Agent Skills with Your Package Manager.
Installation#
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.
skill-forge#
A collection of ready-to-use skills is available as conda packages on the skill-forge channel (source).
To use skills from skill-forge, add the channel and the desired skill packages to your pixi.toml:
[workspace]
channels = ["conda-forge", "https://prefix.dev/skill-forge"]
[dependencies]
polars = ">=1,<2"
[feature.dev.dependencies]
agent-skill-polars = "*"
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/agent-skill-*/share/agent-skills/.
Skills are installed as relative symlinks for portability.
Usage#
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.
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