pi-skill-dollar
v0.2.1
Published
Dollar-sign autocomplete shortcut for pi Agent Skills
Maintainers
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$shifilters skills as you typeTaborEnterselects the highlighted skillEscapecancels the pickerSpacecloses the picker without falling through to file suggestions$check argumentsexpands to/skill:check argumentswhen submitted\$literalsubmits 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-dollarInstall directly from GitHub:
pi install https://github.com/lhl/pi-skill-dollarInstall from a local checkout while developing:
pi install /home/lhl/github/lhl/pi-skill-dollarThen 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:checkFilter by typing:
$shisaPress 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 workflowInline token-boundary usage also works:
Use $shisa-kb to inspect the KB workflowSelecting the skill rewrites just that token:
Use /skill:shisa-kb to inspect the KB workflowEscaping disables the shortcut:
\$not-a-skillBehavior 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 testBuild artifacts in dist/ are committed so direct GitHub installs work:
npm run build
npm pack --dry-runLicense
MIT
