Skip to content

List Pots in the pi package gallery, with a setup skill for pi - #38

Merged
Crokily merged 1 commit into
mainfrom
marketing/pi-package
Nov 9, 2026
Merged

Crokily merged 1 commit into
mainfrom
marketing/pi-package

Conversation

@Crokily

@Crokily Crokily commented Nov 9, 2026

Copy link
Copy Markdown
Owner

Lets the pi package gallery list Pots. pi's docs: "The pi-package keyword makes an npm package eligible for discovery in the Pi package gallery. Optional pi.image and pi.video fields add gallery previews."

The problem with only the keyword. Without a pi manifest, pi loads every skill in a package's skills/ folder. Pots ships its channel skills there (slack-channel, discord-channel, telegram-channel, pages), so pi install npm:pi-durable-bot would put them into a plain pi session, where they do not fit. pi 1.5.0 (dist/core/package-manager.js) uses only the manifest's paths, for every resource type, as soon as the manifest lists one type.

What this changes

  • keywords: adds pi-package and grok-bot-alternative.
  • pi.skills: only ./pi-package/skills. pi.video: the README demo, for the gallery card.
  • pi-package/skills/pots-setup/SKILL.md (shipped in files): a short skill that tells a pi agent what Pots is and sends it to docs/for-agents.md to set Pots up. Pots itself never loads this folder; it loads only skills/.

The keyword reaches npm with the next release. No code changes; CI runs the tests and the install on 3 OS.

- Add the pi-package keyword (and grok-bot-alternative), so pi.dev/packages
  can list Pots, and pi.video for the gallery preview.
- Add a pi manifest that loads only pi-package/skills. Without it, pi would
  load Pots' own channel skills from skills/ into a plain pi session.
- The one skill, pots-setup, points the agent to docs/for-agents.md, so a pi
  user who installs the package gets an agent that can set Pots up.
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 9, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-09T16:10:44.861589Z f1ba1e1 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f1ba1e1f2f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@@ -0,0 +1,15 @@
---
name: pots-setup
description: Set up Pots (npm pi-durable-bot), the open-source Grok Bot alternative: an AI coworker for Slack, Discord and Telegram that reads the channels, decides itself when to act, and works on its own computer, with any model. Use when your person wants an always-on AI teammate or bot in their team chat, or asks about Pots, pi-durable-bot, or an open-source alternative to Grok Bot, OpenAI dots, Claude Duet or Claude Tag.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Quote the setup skill's YAML description

When pi loads this package's setup skill, the unquoted alternative: an AI coworker makes the front matter invalid YAML: a colon followed by a space cannot appear inside a plain scalar. Parsing the front matter locally produces mapping values are not allowed in this context. This prevents the newly advertised setup skill from loading successfully. Quote the description or use a folded block scalar (description: >-).

Useful? React with 👍 / 👎.

@Crokily
Crokily merged commit 6e9fed0 into main Nov 9, 2026
6 checks passed
@Crokily
Crokily deleted the marketing/pi-package branch November 9, 2026 16:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant