@pi-minimal/mention-skills
Minimal $ mentions for pi: autocomplete skills and prompt templates, and point the agent to their files.
Package details
Install @pi-minimal/mention-skills from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@pi-minimal/mention-skills- Package
@pi-minimal/mention-skills- Version
1.0.3- Published
- Oct 30, 2026
- Downloads
- 524/mo · 524/wk
- Author
- evihex
- License
- MIT
- Types
- extension
- Size
- 7 KB
- Dependencies
- 0 dependencies · 2 peers
Pi manifest JSON
{
"extensions": [
"./index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
@pi-minimal/mention-skills
Type $ in the editor to autocomplete skills and prompt templates. Like pi's @
for files, nothing is inlined: before each LLM call, $name gets its file path
and the agent reads the file itself.
- You type and see:
use $jj to commit - The LLM sees:
use $jj (skill: /path/to/jj/SKILL.md) to commit
Install
pi install npm:@pi-minimal/mention-skillsSettings
Put settings in ~/.pi/agent/settings.json (global) or .pi/settings.json
(project), under "pi-minimal"."mention-skills". Merge the keys; do not overwrite
the file. Settings are read at session start (use /reload).
| Key | Type | Default | Meaning |
|---|---|---|---|
disableSkillCommands |
boolean | false |
Hide /skill:* from the / menu. $ still lists skills, and a typed /skill:name still works. |
{ "pi-minimal": { "mention-skills": { "disableSkillCommands": true } } }Behavior
- Names come from your skills and prompt templates. A skill wins on a name clash.
- A mention is
$at line start or after whitespace or( [ { <, then[\w-]+. Unknown names ($HOME,$1) stay as they are. - Like
@for files, the agent decides when to read the file.
Limits
- Prompt templates get no arguments. Write them after the name:
$vocabulary word.