Skip to content

feat(apollo-vertex): add a setup agent skill - #1373

Merged
ruudandriessen merged 2 commits into
mainfrom
t3/vertex-docs-copy-agent-prompt
Oct 16, 2026
Merged

ruudandriessen merged 2 commits into
mainfrom
t3/vertex-docs-copy-agent-prompt

Conversation

@ruudandriessen

@ruudandriessen ruudandriessen commented Oct 15, 2026 •

Copy link
Copy Markdown
Collaborator

Getting an agent to set up Apollo Vertex took a long prompt that copied the Getting started page, and intent install had to be handed back to the user because it only runs in an interactive terminal. This adds a setup skill to the package, so the prompt only has to install the package and load that skill.

The skill has the agent install every peer listed in the installed package's package.json, including the ones marked optional, since the root entry imports them. It also covers private-registry access for the @uipath peers, imports tailwind.css with an @source for the app's files, and sets up TanStack Intent. It adds @tanstack/intent as a dev dependency, adds intent.skills: ["@uipath/apollo-vertex"] to package.json so intent install runs without a terminal, and tells the user it allowed those skills and how to change that. Finally, it adds a UI rule to AGENTS.md and makes sure CLAUDE.md imports it.

On the docs side, the home page's "Start a solution" section has a "Copy prompt for your agent" button, and Getting started shows the same prompt. Getting started drops the uip vss CLI steps and lists the setup skill under agent skills.

The button only works once a release with the setup skill is on npm. semantic-release publishes it when this merges, so the docs may point at it a few minutes early. If the browser blocks the clipboard, the home page links to the prompt on Getting started instead.

I ran the skill end to end in a fresh Vite + React app against a locally packed build of this branch. The prompt loads the skill, and Intent installs with no prompts and lists both skills. The app builds, and Button renders with the Vertex theme. Without the @uipath peers the build fails to resolve @uipath/vs-core, which is why the skill installs the optional peers too. I couldn't install the real @uipath/vs-core and @uipath/proteus-client, since they need private registry access, so I stubbed them for the build. pnpm lint:skills passes.

Copilot AI balanced review requested due to automatic review settings October 15, 2026 13:29
@github-actions

github-actions Bot commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Apollo Coded App preview deployments are ready.

Project Status Preview Updated (PT)
apollo-design Ready Preview · Logs Oct 15, 2026, 07:20:21 AM
apollo-docs Ready Preview · Logs Oct 15, 2026, 07:20:21 AM
apollo-landing Ready Preview · Logs Oct 15, 2026, 07:20:21 AM
apollo-vertex Ready Preview · Logs Oct 15, 2026, 07:20:21 AM

@github-actions github-actions Bot added app:apollo-vertex size:M 30-99 changed lines. labels Oct 15, 2026
@github-actions

github-actions Bot commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Dependency License Review

  • ✅ 1947 package(s) scanned
  • ✅ No license issues found
  • ⚠️ 2 package(s) excluded (see details below)
License distribution
License Packages
MIT 1713
ISC 91
Apache-2.0 56
BSD-3-Clause 28
BSD-2-Clause 23
BlueOak-1.0.0 8
MPL-2.0 4
MIT-0 3
CC0-1.0 3
MIT OR Apache-2.0 2
(MIT OR Apache-2.0) 2
Unlicense 2
LGPL-3.0-or-later 1
Python-2.0 1
CC-BY-4.0 1
(MPL-2.0 OR Apache-2.0) 1
Unknown 1
Artistic-2.0 1
(WTFPL OR MIT) 1
(BSD-2-Clause OR MIT OR Apache-2.0) 1
CC-BY-3.0 1
0BSD 1
(MIT OR CC0-1.0) 1
MIT AND ISC 1
Excluded packages
Package Version License Reason
@img/sharp-libvips-linux-x64 1.3.4 LGPL-3.0-or-later LGPL pre-built binary, not linked
khroma 2.1.0 Unknown MIT per GitHub repo, missing license field in package.json

Copilot AI 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.

🟢 Approval recommended

The localized documentation change has no blocking issues; the dependency reminder is a minor improvement.

1 open finding
What changed in this PR

Adds a copyable setup prompt to the Apollo Vertex docs home page so users can scaffold a solution with their coding agent.

Changes:

  • Replaces “Start a solution” with setup instructions and a Copy button.
  • Adds copied-state feedback and retains the setup-guide link.
  • Directs users to run the interactive skills installer themselves.
File Description
apps/​apollo-vertex/​content/​docs/​_components/​home.tsx Adds the agent prompt and clipboard interaction.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread apps/apollo-vertex/content/docs/_components/home.tsx Outdated
@github-actions

github-actions Bot commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

📊 Coverage + size by package

Per-package bundle size on this PR (no JS/TS source changes detected under packages/* or web-packages/*).

Package Coverage New-line coverage Packed (gzip) Unpacked vs main
@uipath/apollo-core — — — — —
@uipath/apollo-react — — — — —
@uipath/apollo-ui-icons — — — — —
@uipath/apollo-vertex 68.8% — 327.5 KB 1.85 MB +1.6 KB
@uipath/apollo-wind — — — — —
@uipath/ap-chat — — — — —

"Coverage" is each package's own coverage.include scope (e.g. apollo-core instruments only scripts/). "Packed"/"Unpacked" come from npm pack --dry-run and only cover built packages — "—" means not measured this run (package not affected / not built). "vs main" is the packed (gzipped) delta against the last successful main build (the package-sizes artifact from the Release workflow); "—" there means no main baseline was available this run. The baseline is main's latest build, not this PR's exact merge-base, so it includes any drift since the branch diverged. Packages with no vitest config are omitted.

@github-actions

github-actions Bot commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Storybook visual diff

✅ No stories are affected by this PR's changes; nothing to compare. Logs

Updated (PT): Oct 16, 2026, 05:21:48 AM

Copilot AI balanced review requested due to automatic review settings October 15, 2026 14:16
@ruudandriessen
ruudandriessen force-pushed the t3/vertex-docs-copy-agent-prompt branch from f7a4a15 to 7ae7630 Compare October 15, 2026 14:16

Copilot AI 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.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Copilot AI balanced review requested due to automatic review settings October 16, 2026 11:53
@ruudandriessen
ruudandriessen force-pushed the t3/vertex-docs-copy-agent-prompt branch from 7ae7630 to 118003c Compare October 16, 2026 11:53
@ruudandriessen ruudandriessen changed the title docs(apollo-vertex): offer a copyable agent prompt on the docs home page feat(apollo-vertex): add a setup agent skill Oct 16, 2026
@github-actions
github-actions Bot temporarily deployed to preview/apollo-vertex October 16, 2026 11:53 Destroyed
@github-actions github-actions Bot removed the size:M 30-99 changed lines. label Oct 16, 2026
@github-actions
github-actions Bot temporarily deployed to preview/apollo-landing October 16, 2026 11:53 Destroyed
@github-actions github-actions Bot added the size:L 100-499 changed lines. label Oct 16, 2026
@github-actions
github-actions Bot temporarily deployed to preview/apollo-docs October 16, 2026 11:53 Destroyed
@github-actions
github-actions Bot temporarily deployed to preview/apollo-design October 16, 2026 11:53 Destroyed

Copilot AI 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.

🟡 Changes recommended

The setup instructions can omit dependencies needed to resolve root imports in fresh apps.

2 open findings

🧠 Review effort: Balanced

Comment thread packages/apollo-vertex/skills/setup/SKILL.md Outdated
@ruudandriessen
ruudandriessen marked this pull request as ready for review October 16, 2026 12:00
@ruudandriessen
ruudandriessen requested a review from a team as a code owner October 16, 2026 12:00
@ruudandriessen
ruudandriessen requested review from frankkluijtmans and pieman1313 and a balanced review from Copilot October 16, 2026 12:00
@ruudandriessen
ruudandriessen force-pushed the t3/vertex-docs-copy-agent-prompt branch from 118003c to 73f3144 Compare October 16, 2026 12:03
@github-actions
github-actions Bot temporarily deployed to preview/apollo-landing October 16, 2026 12:03 Destroyed
@github-actions
github-actions Bot temporarily deployed to preview/apollo-design October 16, 2026 12:03 Destroyed
@github-actions
github-actions Bot temporarily deployed to preview/apollo-vertex October 16, 2026 12:04 Destroyed
@github-actions
github-actions Bot temporarily deployed to preview/apollo-docs October 16, 2026 12:04 Destroyed

Copilot AI 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.

🔵 Needs a closer look

The setup workflow has unresolved gaps and still needs end-to-end validation in a fresh app before human approval.

4 open findings
1 resolved since last review

🧠 Review effort: Balanced

Comment thread apps/apollo-vertex/content/docs/_components/home.tsx Outdated
Comment thread packages/apollo-vertex/skills/setup/SKILL.md Outdated
Comment thread packages/apollo-vertex/skills/setup/SKILL.md Outdated
The skill sets up an app to use Apollo Vertex: peer dependencies, the stylesheet import,
TanStack Intent with the Vertex skills allowed, and a rule in AGENTS.md that tells agents to
follow the Vertex skills when they change UI.

Assisted-by: Anthropic:claude-opus-5-5
The home page's "Start a solution" section now has a button that copies a short prompt:
install the package, then load and follow the setup skill. Getting started shows the same
prompt, drops the uip vss CLI steps and describes the setup skill under agent skills.

Assisted-by: Anthropic:claude-opus-5-5
Copilot AI balanced review requested due to automatic review settings October 16, 2026 12:15
@ruudandriessen
ruudandriessen force-pushed the t3/vertex-docs-copy-agent-prompt branch from 73f3144 to b91003f Compare October 16, 2026 12:15
@github-actions
github-actions Bot temporarily deployed to preview/apollo-docs October 16, 2026 12:15 Destroyed
@github-actions
github-actions Bot temporarily deployed to preview/apollo-landing October 16, 2026 12:15 Destroyed
@github-actions
github-actions Bot temporarily deployed to preview/apollo-vertex October 16, 2026 12:15 Destroyed
@github-actions
github-actions Bot temporarily deployed to preview/apollo-design October 16, 2026 12:15 Destroyed

Copilot AI 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.

🟢 Approval recommended

No blocking issues were identified in the setup guidance, documentation, or clipboard handling.

0 open findings

4 resolved since last review

🧠 Review effort: Balanced

@ruudandriessen
ruudandriessen merged commit e9a5399 into main Oct 16, 2026
44 of 46 checks passed
@ruudandriessen
ruudandriessen deleted the t3/vertex-docs-copy-agent-prompt branch October 16, 2026 12:23

This branch was successfully deployed

No deployments
preview/apollo-landing — b91003fb Deployed Oct 16, 2026 by github-actions[bot]
preview/apollo-vertex — b91003fb Deployed Oct 16, 2026 by github-actions[bot]
preview/apollo-design — b91003fb Deployed Oct 16, 2026 by github-actions[bot]
preview/apollo-docs — b91003fb Deployed Oct 16, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

app:apollo-vertex size:L 100-499 changed lines.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants