pi-skill-updates

Scans installed agent skills, checks for remote updates across GitHub and registries, and provides update notifications and commands for Pi coding agent

Packages

Package details

extension

Install pi-skill-updates from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-skill-updates
Package
pi-skill-updates
Version
0.1.1
Published
Aug 30, 2026
Downloads
103/mo · 103/wk
Author
shakthi-sagar
License
MIT
Types
extension
Size
31.3 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-skill-updates

A powerful extension for the Pi coding agent that scans installed agent skills, detects remote updates from GitHub repositories and registries, and provides interactive update commands, automatic startup notifications, and AI agent tools.


✨ Features

  • 🔍 Multi-Source Discovery: Scans skills tracked in ~/.agents/.skill-lock.json, project-level lockfiles, and local skill directories.
  • Accurate & Fast Detection: Directly queries remote repository tree hashes via GitHub API (with batching) to instantly know if a skill has changed upstream.
  • 🚀 Interactive Slash Commands:
    • /skills:check — Scans all skills, displays status, and lets you update outdated skills with a single click.
    • /skills:update [skillName] — Updates a specific skill or all outdated skills.
  • 🔔 Background Notifications: Non-intrusive alert on session startup if skill updates are available.
  • 🤖 Agent Tools: Exposes check_skill_updates and update_skills so the AI assistant can check and update skills on request.

📦 Installation

Global Install

pi install npm:pi-skill-updates

Or from local directory:

pi install /path/to/pi-extensions/packages/pi-skill-updates

Try Without Installing

pi -e npm:pi-skill-updates

🛠️ Usage

Commands

  • /skills:check: Checks all installed skills and displays a formatted summary report. If updates are found, it presents an interactive prompt to update them immediately.

  • /skills:update: Updates all outdated skills.

  • /skills:update <skill-name>: Updates the specified skill.

Agent Prompts

You can also ask the AI agent:

  • "Are there any new versions of my skills available?"
  • "Check for skill updates"
  • "Update all my outdated skills"

🔑 Environment Variables

  • GITHUB_TOKEN or GH_TOKEN (Optional): Set a personal GitHub token to avoid GitHub API rate limits when checking public repositories.

📄 License

MIT © Shakthi Sagar