Repository navigation
List Pots in the pi package gallery, with a setup skill for pi - #38
Conversation
- 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.
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
There was a problem hiding this comment.
💡 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. | |||
There was a problem hiding this comment.
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 👍 / 👎.
Lets the pi package gallery list Pots. pi's docs: "The
pi-packagekeyword makes an npm package eligible for discovery in the Pi package gallery. Optionalpi.imageandpi.videofields add gallery previews."The problem with only the keyword. Without a
pimanifest, pi loads every skill in a package'sskills/folder. Pots ships its channel skills there (slack-channel,discord-channel,telegram-channel,pages), sopi install npm:pi-durable-botwould 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: addspi-packageandgrok-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 infiles): a short skill that tells a pi agent what Pots is and sends it todocs/for-agents.mdto set Pots up. Pots itself never loads this folder; it loads onlyskills/.The keyword reaches npm with the next release. No code changes; CI runs the tests and the install on 3 OS.