npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

pi-skill-shiori

v0.6.7

Published

Pi extension that reduces Agent Skill catalog tokens with policy-based skill retrieval and on-demand skill loading.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

eiei114eiei114

Keywords

pi-packagepi-extensionagent-skillsskill-retrieval

Readme

Pi Skill Shiori

CI Publish npm version npm downloads License: MIT Pi Package Trusted Publishing

Pi extension that keeps large Agent Skill catalogs out of the model prompt and loads only the skills that match the current task.

For maintenance priorities and the phased plan, see ROADMAP.md.

What this is

Pi Skill Shiori is a Pi package for vaults or projects with many Agent Skills where the default catalog becomes noisy and expensive. It hides the normal skill catalog when safe, recommends triggerable skills with compact summaries, and loads full SKILL.md bodies on demand.

0.6.6 is the current working release. Prompt-boundary suppression is intentionally conservative: if Shiori cannot safely recognize a catalog boundary, it leaves the prompt untouched and warns instead of deleting too much.

Features

  • Zero-Catalog Mode — hides the normal skill catalog when Pi exposes one in the system prompt.
  • Policy-based retrieval — treats skills as explicit by default and only candidates skills marked as triggerable.
  • Compact candidate injection — injects short skill suggestions instead of full SKILL.md files.
  • On-demand loading — exposes shiori_load_skill so the model can load one selected skill body when needed.
  • Vault-wide skill inventory — indexes skills from project and user-global roots, with optional extra roots in policy.
  • SQLite FTS retrieval — indexes skill names, descriptions, and policy triggers with node:sqlite + FTS5, with token-match fallback.
  • Recommendation reason badges — compact [trigger], [description], and [low match] labels on surfaced skills.
  • Session-local feedback metrics — /shiori:stats tracks offers, loads, and follow-through without storing prompts.

Install

Global install from npm

pi install npm:[email protected]

Without a version pin:

pi install npm:pi-skill-shiori

Project-local install from npm

pi install -l npm:[email protected]

Without a version pin:

pi install -l npm:pi-skill-shiori

Install from GitHub

pi install git:github.com/eiei114/[email protected]
pi install -l git:github.com/eiei114/pi-skill-shiori

Try without installing

pi -e npm:pi-skill-shiori
pi -e git:github.com/eiei114/pi-skill-shiori

Local development install

pi install -l /absolute/path/to/pi-skill-shiori

Quick start

  1. Install the package (see Install).
  2. Create .pi/skill-shiori.yml in your Pi project (see Docs/usage.md).
  3. Start Pi and run /shiori:doctor to confirm policy path, indexed roots, and suppression status.
  4. Use /shiori:bootstrap to draft a policy from discovered skills, then /shiori:reload after edits.
  5. Ask the agent for help; Shiori injects compact candidates or use /shiori:recommend for an interactive flow.

Commands take no inline arguments. Details are collected after launch via Pi UI prompts.

Usage summary

| Command | Purpose | |---|---| | /shiori:doctor | Show policy path, indexed roots, inventory count, retrieval backend, suppression status, and code marker. | | /shiori:bootstrap | Generate a review draft policy from discovered skill descriptions. | | /shiori:reload | Rebuild Shiori skill inventory; optionally ask Pi to reload runtime resources. | | /shiori:recommend | Interactive recommendation flow with optional pre-load. | | /shiori:stats | Show operational counters and recommendation quality summary. |

Shiori registers one tool:

shiori_load_skill({ skill: "reddit-research" })

The model receives the full selected SKILL.md content. The Pi UI shows a compact result like ✓ Loaded reddit-research (6.3KB).

Recommended skills show compact reason badges ([trigger], [description], [low match]). See Docs/recommendation-surface.md for badge vocabulary and metrics interplay.

For inventory roots, policy YAML, suppression statuses, and feedback metrics, see Docs/usage.md.

Package contents

| Path | Purpose | |---|---| | src/ | Pi extension entrypoint and Shiori runtime | | Docs/usage.md | Configuration, inventory, suppression, and metrics details | | Docs/recommendation-surface.md | Recommendation badges and surface behavior | | ROADMAP.md | Maintenance direction and phased plan | | CHANGELOG.md | Version history | | SECURITY.md | Vulnerability reporting |

Development

git clone https://github.com/eiei114/pi-skill-shiori.git
cd pi-skill-shiori
npm install
npm run typecheck
npm test

Run in a Pi project without installing globally:

pi -e /absolute/path/to/pi-skill-shiori

Release

Releases are automated via Trusted Publishing:

  1. Bump version in package.json and update CHANGELOG.md.
  2. Merge to main.
  3. Auto Release tags v<version> and creates a GitHub release.
  4. The tag triggers Publish, which publishes to npm with provenance.

Maintainer checks before merge:

npm run typecheck
npm test
npm run release:npm:dry

For version history, see CHANGELOG.md.

Security

Pi packages execute local code with the same permissions as Pi. Review third-party packages before installing them.

Shiori does not sandbox skills. It only changes how skill candidates are discovered and loaded. A loaded skill can still instruct the model to run tools, edit files, or execute commands according to your Pi/tool permissions.

For vulnerability reporting, see SECURITY.md.

Links

License

MIT