@saifymatteo/pi-skill-usage-log

Log which skills were actually used; /skill-usage summary.

Packages

Package details

extension

Install @saifymatteo/pi-skill-usage-log from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@saifymatteo/pi-skill-usage-log

Package: @saifymatteo/pi-skill-usage-log
Version: 0.1.4
Published: Nov 7, 2026
Downloads: 749/mo · 749/wk
Author: saifymatteo
License: AGPL-3.0-only
Types: extension
Size: 56.2 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "image": "https://raw.githubusercontent.com/saifymatteo/pi-extensions/main/packages/pi-skill-usage-log/screenshot.png",
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

pi-skill-usage-log

/skill-usage report of loaded and used skills across projects

/skill-usage shows which installed skills were loaded and which were actually used, across all projects.

Passively record skill loads and subsequent tool activity, then show cross-project usage without adding the report to conversation context.

Running locally

From the monorepo root:

pi -e ./packages/pi-skill-usage-log

Warning: this extension uses your existing Pi resources and settings unless you load it in an isolated home (see the root README). Do not load two copies of the same extension (for example an older standalone file alongside this package): commands and hooks can duplicate. The package never installs or relocates personal settings.

Commands and shortcuts

/skill-usage — opens the all-project report (no arguments).
Up/Down, PageUp/PageDown, Home/End scroll; Escape/Ctrl+C/Enter close.

Settings and storage

Appends TSV rows to <agent-dir>/skill-usage.log; <agent-dir> is PI_CODING_AGENT_DIR or ~/.pi/agent. No configuration file. Both legacy six-column and model/thinking eight-column rows are read. Loaded/used events are deduplicated per session.

Privacy and operations

Log stores timestamps, session IDs, working directories, skill names/paths and selected agent model/thinking level. It is persistent local history with no rotation or removal feature. No prompt text, tool result content or network requests are logged/sent. A successful SKILL.md read followed by another non-think tool call in the same request counts as use; this is a heuristic, not proof. Merely loading this package enables tracking.

Compatibility

Node.js >=24 for development checks; run extensions through Pi's TypeScript loader. Host imports are wildcard peers, not bundled runtime copies. Reports require interactive terminal mode; tracking uses Pi lifecycle and tool hooks. Installed skill listing depends on getCommands() skill metadata. Older historical counts use a narrower same-turn heuristic and cannot be repaired.

See NOTICE.md for provenance. Tests use the monorepo's TypeScript dev dependency and VM loader; they do not contact services or write to user-home resources.