sean-pedersen-pi-context-skills

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# 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

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:

/add @sean_pedersen/pi-context-skills

Or install directly from GitHub:

/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:

.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

/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