@vanillagreen/pi-skills-manager

Polished Pi skills manager with a dedicated /skill menu for browsing, previewing, inserting, creating, editing, renaming, deleting, and toggling skills while preserving native /skill:name invocation.

Packages

Package details

extension

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

npm repohome report
$ pi install npm:@vanillagreen/pi-skills-manager
Package
@vanillagreen/pi-skills-manager
Version
2.0.5
Published
Oct 23, 2026
Downloads
744/mo · 88/wk
Author
vanillagreencom
License
MIT
Types
extension
Size
315.6 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "image": "https://raw.githubusercontent.com/vanillagreencom/kendex/main/pi-extensions/pi-skills-manager/assets/skills-manager.png",
  "extensions": [
    "./extensions/skills-manager.ts"
  ]
}

Security note

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

README

@vanillagreen/pi-skills-manager

A skill browser and editor for Pi. You can find installed skills, insert their commands and manage skills you own.

Skills Manager overlay

Features

  • Search and preview project, user and package skills.
  • Insert a selected skill command into the editor.
  • Create, edit, rename and delete your own skills.
  • Enable or disable installed skills.
  • Optionally ask the current model to draft a skill.

Install

  • npm: pi install npm:@vanillagreen/pi-skills-manager.
  • kendex: add the declaration below to the project's kendex.toml, or to ~/.config/kendex/kendex.toml for user scope. Run kendex update-pi.
[pi-extensions."@vanillagreen/pi-skills-manager"]
source = "kendex"

Restart Pi after installation. Use kendex update-pi --check to preview the installation.

How it works

The manager reads the skills Pi has discovered. You select a skill to preview it or insert its command into the editor. Changes to enabled skills go to Pi's settings. Changes to skills you own write their files to the chosen location.

Memory use

  • The skill list is loaded when /skill opens the manager and released when it closes. A session that never opens it, with or without a UI, loads nothing.
  • The list holds each skill's name, description and metadata. To get them, opening the list reads each skill's file, and the list keeps no skill's body. The manager reads a skill's body from its file again when it shows that skill.
  • While it is open, the manager also keeps one search string per listed skill, rebuilt when the list reloads, and the laid-out lines of the skill it previews at one width. Both go when it closes.

Setup

The settings editor writes project values to .pi/settings.json. The default user file is ~/.pi/agent/settings.json. PI_CODING_AGENT_DIR changes the user directory. Package values are stored under kendex.extensionManager.config["@vanillagreen/pi-skills-manager"].

Open /extensions:settings; settings appear under the Skills Manager tab. Project settings in .pi/settings.json apply only after Pi marks the workspace trusted. glyphStyle picks unicode or ascii symbols, and @vanillagreen/pi-tool-renderer's globalGlyphStyleOverride wins when set.

  • enabled: package toggle.
  • hideStartupSkillsBlock: hide Pi's startup [Skills] list.
  • aiGenerationEnabled, defaultCreateLocation: how and where a created skill is drafted.
  • popupWidth, popupMaxHeight, listRows: overlay size; short terminals shrink the list so the controls stay visible.

Based on ideas from the MIT-licensed @kmiyh/pi-skills-menu; see THIRD_PARTY_NOTICES.md. Maintainer notes are in DEVELOPMENT.md.

Licence

MIT