pi-skill-dollar

Dollar-sign autocomplete shortcut for pi Agent Skills

Packages

Package details

extension

Install pi-skill-dollar from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-skill-dollar
Package
pi-skill-dollar
Version
0.2.1
Published
Aug 28, 2026
Downloads
185/mo · 158/wk
Author
lhl
License
MIT
Types
extension
Size
17.5 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./dist/extension.js"
  ]
}

Security note

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

README

pi-skill-dollar

pi-skill-dollar is a small pi extension that adds a $ autocomplete shortcut for Agent Skills.

It lets you type $ anywhere a new token can start and pick from the same skill command list that powers /skill:<name>.

Features

  • $ opens a skill autocomplete picker at prompt start or after whitespace
  • $shi filters skills as you type
  • Tab or Enter selects the highlighted skill
  • Escape cancels the picker
  • Space closes the picker without falling through to file suggestions
  • $check arguments expands to /skill:check arguments when submitted
  • \$literal submits as literal $literal

Requirements

  • pi 0.79.1 or newer (native extension autocomplete triggers)
  • Node.js 22.19 or newer when installing from npm/GitHub
  • Skill commands enabled in pi (enableSkillCommands, enabled by default in recent pi releases)

Install

Install from npm:

pi install npm:pi-skill-dollar

Install directly from GitHub:

pi install https://github.com/lhl/pi-skill-dollar

Install from a local checkout while developing:

pi install /home/lhl/github/lhl/pi-skill-dollar

Then run /reload or restart pi.

Usage

At the beginning of the input:

$

This opens the skill picker. Selecting check inserts/submits the native skill command path:

/skill:check

Filter by typing:

$shisa

Press Tab to accept a match and leave a trailing space for arguments:

$shisa-kb<tab>
# becomes
/skill:shisa-kb

Alternatively, press Space to close the picker and keep typing with the short form. It expands when submitted:

$shisa-kb inspect the KB workflow
# submitted as
/skill:shisa-kb inspect the KB workflow

Inline token-boundary usage also works:

Use $shisa-kb to inspect the KB workflow

Selecting the skill rewrites just that token:

Use /skill:shisa-kb to inspect the KB workflow

Escaping disables the shortcut:

\$not-a-skill

Behavior Notes

$ only triggers at a token boundary: prompt start or after a space/tab. It does not trigger inside ordinary words.

Examples:

Input Behavior
$ Opens skill picker
$check Filters to matching skills
$check<tab> Accepts match and rewrites to /skill:check
$check<space> Inserts a normal space and closes picker; expands on submit
foo $check Opens inline picker
foo$check No special handling
\$check Literal $check

Development

npm install
npm run check
npm test

Build artifacts in dist/ are committed so direct GitHub installs work:

npm run build
npm pack --dry-run

License

MIT