@zigai/pi-mention-skill0.11.0

Pi package that moves skill discovery from slash commands to $ mentions.

zigai Published 8 days ago MIT ~1.4K downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Reports 0

No reports yet.

Readme

Pi Mention Skill

Move Pi skill selection from slash autocomplete to $ mentions.

Install

pi install npm:@zigai/pi-mention-skill

Features

Adds fuzzy skill autocomplete with $ mentions.
Ranks initial suggestions by frecency, recency, frequency, name, or command order.
Supports custom triggers, pinned skills, and optional project-local priority.
Expands mentions such as $skill-name before the model sees the prompt.
Keeps /skill:* entries out of slash autocomplete by default.

Usage

Type $ in the prompt editor to open skill suggestions, then select a skill.

The selected mention loads the same skill content that /skill:name would have loaded, while keeping skills out of the normal slash command picker.

History-based ordering records autocomplete selections in ~/.pi/agent/state/pi-mention-skill-selections.json. Frecency combines selection count with recency; manually typed mentions do not update this history.

Configuration

Global settings are stored in ~/.pi/agent/extension-settings/pi-mention-skill.json.

Option	Type	Default	Description
`trigger`	string	`"$"`	One or more non-whitespace, non-slash characters that start a skill mention.
`hideSlashSkills`	boolean	`true`	Hide skill commands from slash-command completion.
`completionSuffix`	string	`" "`	Text inserted after a completed skill mention.
`initialSuggestions.strategy`	`frecency` \| `recent` \| `frequent` \| `alphabetical` \| `sourceOrder`	`"frecency"`	Ordering used before any skill query text is entered.
`initialSuggestions.pinned`	string[]	`[]`	Skill names placed first, in this order, before the configured strategy.
`initialSuggestions.projectSkillsFirst`	boolean	`false`	Place project-local skills before user and temporary skills in initial suggestions.

{
  "$schema": "./schemas/pi-mention-skill.schema.json",
  "trigger": "$",
  "hideSlashSkills": true,
  "completionSuffix": " ",
  "initialSuggestions": {
    "strategy": "frecency",
    "pinned": [],
    "projectSkillsFirst": false
  }
}

License

MIT