@sean_pedersen/pi-context-skills

Pi coding agent extension that uses project context and the active LLM to select only relevant skills per project

Packages

Package details

extension

Install @sean_pedersen/pi-context-skills from npm and Pi will load the resources declared by the package manifest.

npm repo report
$ pi install npm:@sean_pedersen/pi-context-skills
Package
@sean_pedersen/pi-context-skills
Version
0.1.0
Published
May 26, 2026
Downloads
98/mo · 29/wk
Author
sean_pedersen
License
MIT
Types
extension
Size
21.3 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-context-skills

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

Features

  • Discovers project-local, user, Claude, and custom skills
  • Uses compact project context (dir tree, README etc.) to select using default model relevant skills on first run
  • Falls back to local heuristics when no model/auth is available
  • 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 first launch in a project, the extension discovers available skills and selects a relevant subset. The selected skills are saved to:

.pi/skills-selection.json

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 uses conservative heuristics and always enables project-local skills.

License

MIT