snqb/pi-manager

Pi Manager Skill

Use this skill to manage the Pi environment itself. Install community packages, manage extensions, and keep your agent up to date.

Tools

1. List Packages

View installed packages and extensions.

pi list

2. Install Package

Install a package from NPM or Git.

# From NPM
pi install npm:<package_name>

# From Git
pi install git:<repo_url>

Note: Installs globally to ~/.pi/agent. Use -l for project-local install.

3. Remove Package

Remove an installed package.

pi remove <package_name>

4. Update Packages

Update all installed packages to latest versions.

pi update

5. Config Check

Check current configuration and enabled resources.

pi config

Knowledge Base

Official Repositories:

• Core: https://github.com/badlogic/pi-mono (Docs in packages/coding-agent/docs)
• Skills: https://github.com/badlogic/pi-skills (Community skills)

Finding Skills: To find new skills, ask the agent to search GitHub for the pi-package topic or check the official pi-skills repo.

Troubleshooting Skill Conflicts

Pi validates skills at startup. Common issues:

"description is required"

Every skill needs YAML frontmatter with a description field:

---
name: my-skill
description: What it does and when to use it.
---

Common causes:

• Stray .md files in the skills root (e.g., README.md). Pi discovers all .md files at ~/.pi/agent/skills/ root as potential skills. Fix: rename to no extension (README) or move out.
• SKILL.md missing frontmatter. Add --- fenced YAML block at the top with at least name and description.

Name collisions

Two skills with the same name from different locations. First one found wins. Fix: rename one.

Name validation

Skill names must: be lowercase, use only a-z, 0-9, hyphens, no leading/trailing/consecutive hyphens, max 64 chars, match parent directory name.

Discovery rules

• Direct .md files in ~/.pi/agent/skills/ root → each is a skill
• SKILL.md files in subdirectories → dirname is the skill
• Packages: skills/ dirs or pi.skills in package.json

Quick diagnosis

# See what pi discovers
pi list

# Find .md files that might be accidentally picked up
ls ~/.pi/agent/skills/*.md

# Check a skill has valid frontmatter
head -5 ~/.pi/agent/skills/my-skill/SKILL.md

Examples

User: "Install the linear integration." Agent: pi install npm:@mariozechner/pi-linear

User: "What extensions do I have?" Agent: pi list

User: "Update everything." Agent: pi update

User: "Find a skill for browser automation." Agent: (Searches badlogic/pi-skills) -> "Found browser-tools in the official repo."