Frank
651924a4bc
Three parallel trees documented the same ecosystem: omp-docs/skills/
(two overview pages), tools/npx-skills/ (10 pi-era npm pages), and
tools/vercel-labs-skills/ (11 CLI pages), plus a fourth leaderboard page
at engineering/skills-ecosystem.md. Verbatim overlap (identical SKILL.md
field tables in skills-spec.md vs skill-format.md; 13-agent vs 68-agent
copies of the same upstream table). Consolidated to four concept pages:
- skills/agent-skills.md: standard, format, loading, authoring (merges
skills-spec, skill-format, skill-file-structure, skill-loading,
best-practices, skills-vs-extensions)
- skills/skills-cli.md: CLI reference (merges commands, source-formats,
installation-scope, skill-discovery, lock-file, env-variables,
agent-support, related-links)
- skills/store-wiring.md: moved, fleet ops, links retargeted
- skills/ecosystem.md: replaces skills-ecosystem.md; stale 2026-08-12
top-50 table dropped, replaced with a live top-10 re-queried from the
skills.sh API tonight and the API contract re-verified (zero-based,
200/page, {skills,total,hasMore,page}, total 9909)
All facts re-verified 2026-10-19 against primary sources:
agentskills.io, vercel-labs/skills README + src/cli.ts (command set,
--full-depth) + src/skill-lock.ts (v3 lock, XDG path, wipe-on-old),
live skills.sh API. Deleted superseded core/index-doc.md (old pi-era
docs index). Retargeted all inbound links (tools/index, engineering x3,
packages x3, pi/skills, core/index). Pi-era npm skill packaging is
listed as archived under /pi/.
Refs #29
38 lines
1.9 KiB
Markdown
38 lines
1.9 KiB
Markdown
---
|
|
type: reference
|
|
title: Pi Permission System
|
|
description: Permission enforcement and policy configuration system for pi-coding-agent extensions.
|
|
resource: https://github.com/gotgenes/pi-permission-system
|
|
tags:
|
|
- pi
|
|
- package
|
|
- permissions
|
|
- unverified
|
|
timestamp: 2026-08-28
|
|
---
|
|
[pi-permission-system](https://github.com/gotgenes/pi-permission-system) is the permission enforcement and policy configuration system for pi-coding-agent extensions.
|
|
|
|
---
|
|
|
|
## Documentation Index
|
|
|
|
| Document | File | Description |
|
|
|----------|------|-------------|
|
|
| Overview | README.md | Package overview, install, quick start, feature list |
|
|
| Configuration | configuration.md | Full policy reference, runtime knobs, per-agent overrides, common recipes |
|
|
| Session Approvals | session-approvals.md | Session-scoped rules, pattern suggestions, bash arity table |
|
|
| Cross-Extension API | cross-extension-api.md | Service accessor, event bus, decision/UI-prompt broadcasts |
|
|
| Subagent Integration | subagent-integration.md | Permission forwarding, coexistence with subagent extensions |
|
|
| Frontmatter Convention | permission-frontmatter-for-subagent-extensions.md | Convention guide for subagent extension authors |
|
|
| OpenCode Compatibility | opencode-compatibility.md | Shared concepts, divergences, porting guide |
|
|
| Troubleshooting | troubleshooting.md | Common issues, diagnostic logging, threat model |
|
|
| Migration: Legacy → Flat | legacy-to-flat.md | Migration from pre-v2 config layout |
|
|
| Migration: Strict Validation | strict-config-validation.md | Strict config validation (breaking) — reading and fixing rejected configs |
|
|
|
|
---
|
|
|
|
## Cross-References
|
|
|
|
- See [Skills](../skills/index.md) for the skill toolchain that replaced pi-package distribution.
|
|
- See [AGENTS.md Format](../core/agents-md-format.md) for the system-level instruction format that governs how this system is referenced in agent contracts.
|