---
slug: "sean-pedersen-pi-context-skills"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/SeanPedersen/pi-context-skills@main/README.md"
repo: "https://github.com/SeanPedersen/pi-context-skills"
source_file: "README.md"
branch: "main"
---
# pi-context-skills

A Pi coding agent extension that keeps skill context small by selecting only the skills relevant to the current project.

Disclaimer: global skills only disappear from system prompt after first user message.

## Features

- Discovers project-local, user, Claude, and custom skills
- Uses the active Pi model plus compact project context (dir tree, README etc.) to select relevant skills on first run
- Stores an empty conservative selection if the active model is unavailable or returns no usable response
- Stores per-project selections in `.pi/skills-selection.json`
- Injects only enabled skills into the agent system prompt
- Provides `/skills` commands to list, edit, and reset selections
- Shows selection status with a `[Context-Skills]` UI header

## Installation

Install as a Pi package:

```text
/add @sean_pedersen/pi-context-skills
```

Or install directly from GitHub:

```text
/add https://github.com/SeanPedersen/pi-context-skills
```

## Usage

On each Pi session start in a project with an existing selection, the extension shows the current skill summary immediately. When no saved selection exists, it discovers available skills and asks the active Pi model to select a relevant subset when needed. The selected skills are saved to:

```text
.pi/skills-selection.json
```

If selection fails, the extension saves an empty selection and continues without heuristics.

The extension then replaces Pi's default skill section with only the enabled skills for that project.

## Commands

```text
/skills          Edit this project's skill selection
/skills edit     Edit this project's skill selection
/skills list     Show selected and available skills
/skills reset    Re-run skill selection for this project
```

## Skill discovery

Skills are discovered from:

- `<project>/.claude/skills`
- `~/.agents/skills`
- `~/.claude/skills`
- Paths listed in `PI_SKILL_PATHS`

`PI_SKILL_PATHS` uses the platform path delimiter (`:` on macOS/Linux, `;` on Windows).

## Selection behavior

The extension asks the active Pi model to select relevant skills using compact context from:

- top-level project file list
- `README.md` or `README`
- `package.json`
- `pyproject.toml`

If model selection is unavailable, it keeps the selection empty and surfaces the failure in the `[Context-Skills]` status.

## License

MIT