Repository navigation
Conversation
Pi reads the Agent Skills folder ~/.agents/skills in every project, so `npx hyperframes skills update` already installs the core skills for it and the CLI already skips Pi in the mirror fan-out. Nothing on the site said so: there was no setup page, no row in the plugins table, and Pi was missing from the agent lists in the FAQ, the quickstart and the README. The new page covers both install routes, the /skill:hyperframes spelling Pi uses, and the project-trust question when the skills live in the project's .agents/skills folder.
Preview approval requiredThis pull request comes from a fork, so Mintlify won't build a preview until someone with write access approves commit |
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds Pi (earendil-works/pi) to the documented agents: a setup page at
/guides/with-pi, a row in the plugins table, a section on the standalone-skills page, and Pi in the agent lists in the FAQ, the quickstart and the README.Why
HyperFrames already works with Pi without any per-agent install:
npx hyperframes skills updatecopies the core skills into the shared~/.agents/skillsfolder, which Pi reads in every project.skillsMirrordeliberately skips Pi in the mirror fan-out because its universal copy is authoritative (UNIVERSAL_STORE_READERS, Global skill mirroring should avoid redundant agent directories and provide target controls #3294).agent_runtime.tsalready fingerprintspias an agent runtime.The site never said any of that, so a Pi user had no setup page and no reason to expect the skills to load. I checked the open and closed issues and PRs first: nothing asks for this, and #3325 only covers the mirror behaviour.
How
docs/guides/with-pi.mdx— the new page: both install routes, the/skill:hyperframesspelling Pi uses, project trust, preview and render, troubleshooting.docs/docs.json—guides/with-piin the "Use it with your agent" group.docs/guides/plugins.mdx— a Pi row and a mention in the intro, since Pi has no plugin of its own.docs/guides/skills.mdx— a short "Use the skills in Pi" section that points at the page.docs/faq.mdx,docs/quickstart.mdx,README.md— name Pi in the agent lists that were already there.Pi's slash command is
/skill:<name>rather than a bare/hyperframes, so the page gives the prompt in the form Pi accepts while the other agents keep theirs.Test plan
npx skills add <checkout> --skill hyperframes --global --agent claude-code universal --copylands the bundle in~/.agents/skills/hyperframes; with that folder in place,pi --printlistshyperframesamong its available skills.npx skills add <checkout> --skill hyperframes --agent pi --copyin a scratch project writes.agents/skills/hyperframes, which is the project route the page documents.docs/docs.jsonparses as JSON, andoxfmtreformatted nothing in the touched files.