Skip to content

feat(prompts): RM-19078 Publish agent setup prompts to npm - #18

Open
xavierandueza wants to merge 76 commits into
mainfrom
xavier/rm-19078-publish-agent-setup-prompts-from-agent-plugins-and-auto-sync
Open

xavierandueza wants to merge 76 commits into
mainfrom
xavier/rm-19078-publish-agent-setup-prompts-from-agent-plugins-and-auto-sync

Conversation

@xavierandueza

@xavierandueza xavierandueza commented Oct 13, 2026 •

Copy link
Copy Markdown
Contributor
🚥 Resolves RM-19078

🧰 Changes

Makes a thin JS package that just exports the individual setup prompts (based on what we have in skills) to an NPM package.

WHY?

To make sure that we base the instructions that homepage (and eventually the monorepo) shows to users doesn't drift from the rest of the skills.

This way, we can, on a new release trigger we will create PRs in the readme and homepage repos. Makes keeping in-sync long term easier, while still letting us actually show the prompts to the user.

Need Assistance

The release and downstream workflows need setup before they work. Until then we're hard-coding these in homepage.

  • Install the ai-deploy-readme Github App on both agent-plugins and homepage repos
    • Add the AI_DEPLOY_APP_ID / AI_DEPLOY_PRIVATE_KEY secrets to this repo - need so that it can create PRs in homepage (and eventually monorepo)
  • Publish @readme/agent-plugins to npm - needs to be a member of readme team on npm
    • Add this repo's release.yml to the npm package's trusted publishing (should be under "Github Actions")
  • Approval + Merge for the PR to add pnpm support for update-downstream-deps

🧬 QA & Testing

  • Read over all generated content, LGTM.

xavierandueza and others added 30 commits October 2, 2026 17:18
…t-skills

feat(skills): Improve Edit Page Content Skill
ty tony

Co-authored-by: Tony Li <runnabro@users.noreply.github.com>
…n-skill

feat(navigation): Improve manage navigation skill
@xavierandueza xavierandueza self-assigned this Oct 13, 2026
@greptile-apps

greptile-apps Bot commented Oct 13, 2026 •

Copy link
Copy Markdown

RetriggerConfidence Score: 5/5

[High impact] No confirmed blocking issue remains in the changes since the previous review.

Reviews (2) · Last reviewed commit: "chore: drop node_version from homepage d..." · Reviewed by Greptile

Comment thread .github/workflows/release.yml Outdated

@xavierandueza xavierandueza left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

self-reviewed, LGTM

Comment thread prompts/all.md

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

NOTE - everything under prompts/ aren't used by anything aside from checking final output.

I wanted left in because its good to be able to see, as a user, what these final prompts are.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

(agent response)
No code change. One correction: prompts/ is used for more than reviewing output. It does three things:

  • It's the release trigger. release.yml runs on pushes to main under prompts/**, so a change to the client instructions only publishes once the regenerated prompts are committed.
  • It's shipped in the npm package. files includes prompts/, and exports exposes @readme/agent-plugins/prompts/<key>.md, which the README documents. Consumers that want raw Markdown read it directly rather than through setupPrompts.
  • It's the drift check. build-prompts.mjs --check compares these files with the client instructions in Validate.

So keeping it committed matters beyond readability. If we only wanted it for review, we'd also need to change the release trigger and drop the raw Markdown export.

@xavierandueza
xavierandueza marked this pull request as ready for review October 13, 2026 10:25
greptile-apps[bot]
greptile-apps Bot previously approved these changes Oct 13, 2026
@xavierandueza
xavierandueza changed the base branch from feature/add-custom-content-and-generic-agent-setup-instructions to main October 14, 2026 04:04
@greptile-apps
greptile-apps Bot dismissed their stale review October 14, 2026 04:09

Dismissed because a newer commit was pushed; Greptile will re-review the current head.

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