Files

T

Frank 02883d3ed2 docs: rebuild KB in OKF v0.1 with live-verified facts

Copy of the legacy ~/.pi/agent/docs tree rebuilt as the command-center
knowledge base: concept files promoted to path identity, index listings
stripped of frontmatter, all wikilinks/relative links resolved, every
checkable claim verified against the live fleet (Dankserver = Ryzen 7
7700X + RTX 3090; Strix Halo is Dankclaw), unverifiable claims tagged.
kb-lint exits 0.

2026-08-28 07:57:13 -07:00

2.1 KiB

Raw Blame History

type, title, description, tags, timestamp, verified

type

title

description

Pi Packages — The Distribution Mechanism

Pi packages are npm packages that declare resources via a pi manifest in package.json. They are the primary way to distribute skills (along with extensions, prompts, and themes) through npm.

Package Structure

my-pi-package/
├── package.json              # npm metadata + pi manifest
├── skills/                   # Conventional directory (auto-discovered)
│   ├── my-skill/
│   │   └── SKILL.md
│   └── another-skill/
│       └── SKILL.md
├── extensions/               # TypeScript extensions
├── prompts/                  # Prompt templates
├── themes/                   # TUI themes
└── README.md

Package.json with pi Manifest

{
  "name": "my-pi-package",
  "keywords": ["pi-package"],
  "pi": {
    "extensions": ["./extensions"],
    "skills": ["./skills"],
    "prompts": ["./prompts"],
    "themes": ["./themes"]
  }
}

Gallery Metadata

Packages tagged with pi-package appear on the pi.dev/packages gallery. Add preview media:

{
  "pi": {
    "skills": ["./skills"],
    "video": "https://example.com/demo.mp4",
    "image": "https://example.com/screenshot.png"
  }
}

Two-Layer Model

npm package (tagged pi-package)
├── pi.skills manifest → points to ./skills/
└── skills/
    ├── brave-search/SKILL.md
    ├── browser-tools/SKILL.md
    └── tdd-workflow/SKILL.md

Skills are the content (SKILL.md + scripts). Pi packages are the delivery mechanism (npm tarball with a pi manifest).

Installation — How to install pi packages
Skill File Structure — What goes inside a skill

2.1 KiB Raw Blame History