How do I install the Pi Manager skill?

Run npx skillmds@latest add snqb/pi-manager in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Pi Manager safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Pi Manager?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Pi Manager free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Pi Manager?

snqb (@snqb) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Pi Manager by snqb — Agent Skill

Name: Pi Manager
Rating: 4.2 (5 reviews)
Author: snqb

File contents

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."

---name: pi-managerdescription: Manage the Pi environment - install packages, list extensions, update tools, and query configuration. Includes knowledge of official repositories and community skills.---# Pi Manager SkillUse this skill to manage the Pi environment itself. Install community packages, manage extensions, and keep your agent up to date.## Tools### 1. List PackagesView installed packages and extensions.```bashpi list```### 2. Install PackageInstall a package from NPM or Git.```bash# From NPMpi install npm:<package_name># From Gitpi install git:<repo_url>```**Note:** Installs globally to `~/.pi/agent`. Use `-l` for project-local install.### 3. Remove PackageRemove an installed package.```bashpi remove <package_name>```### 4. Update PackagesUpdate all installed packages to latest versions.```bashpi update```### 5. Config CheckCheck current configuration and enabled resources.```bashpi 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 ConflictsPi validates skills at startup. Common issues:### "description is required"Every skill needs YAML frontmatter with a `description` field:```yaml---name: my-skilldescription: 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 collisionsTwo skills with the same name from different locations. First one found wins. Fix: rename one.### Name validationSkill 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```bash# See what pi discoverspi list# Find .md files that might be accidentally picked upls ~/.pi/agent/skills/*.md# Check a skill has valid frontmatterhead -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."

Frequently asked questions

Pi Manager