Surface agent skills on the Diffs and Trees sites - #1078
Merged
Conversation
Each product now knows where its published agent skill lives and how to install it, so the site can point people at the skill instead of leaving them to find it on skills.sh by hand. Add `skillUrl` and `skillInstallCommand` to the product config, and a `getAgentPrompt` helper that builds a paste-ready prompt: install the skill through the Skills CLI, then read the docs and `llms-full.txt`. Nothing consumes these yet.
Someone reading the Diffs install page or the Trees overview had no way to discover that we publish an agent skill for the package. They now get a short "Agent skill" section with the `npx skills add` command, a link to the skills.sh listing, and a pointer to `llms.txt` for agents that read plain text instead. Add the install command as a docs code example in each section's constants and wire it through the MDX scope, so it copies and renders like every other snippet on the page.
Every hero button asked for `size="xl"` and then overrode it with the same `h-11 rounded-lg px-5 text-sm md:h-12 md:text-base`, so the size's own `rounded-md px-7` never actually rendered anywhere. Move those styles onto the variant so call sites can just ask for the size. The xl size now grows at the `md` breakpoint. `EditHero` opts out of that: it strips its own sizing with an unqualified `h-[auto]`, and tailwind-merge only reconciles utilities that share a modifier, so a bare `h-[auto]` does not suppress the new `md:h-12`. Pin `md:h-[auto]` and `md:text-sm` there to hold its current rendering.
The Diffs and Trees heroes gain a "For Agents" button next to the install command. Opening it offers the Skills CLI command that installs the package's agent skill, a paste-ready prompt for agents with no skill support, and a link to the skills.sh listing. Copying leaves the menu open, so both the command and the prompt can be taken in one visit. Extract the copy affordance into a shared `CopyStateIcon` so the install button and the menu rows confirm the same way. Both icons stay mounted and stacked in a fixed box, and the check pops in on the timing the Bootstrap checkbox mark uses. The transition names the `scale` property rather than `transform`, because Tailwind v4 emits scale utilities on standalone `scale` and leaves `transform` as `none`. The menu centers under the trigger below the breakpoint where the hero buttons stack full width, and left-aligns once they sit inline.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
|
The agent skill was a subsection of Installation on Diffs and Overview on Trees, which buried it and left no room to cover anything beyond the install command. Promote it to its own top-level section on both sites so the skill, a paste-ready prompt for agents without skill support, and the plain-text docs sit together near the top of the sidebar. Register the section with the llms.txt generator as well. That script works off an explicit section list rather than the directory, so without this the new page would be missing from llms.txt and llms-full.txt.
SlexAxton
approved these changes
Aug 18, 2026
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
2 participants
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.
npx skills addcommand, a paste-ready prompt for agents without skill support, and a link to the skills.sh listing. Copying leaves the menu open so both can be taken in one visit.llms.txtgenerator, which walks an explicit section list rather than the directory.skillUrl,skillInstallCommand, and agetAgentPrompthelper to the product config, so the skill location lives in one place.CopyStateIconso the install button and the menu rows confirm a copy identically. Both icons stay mounted and stacked in a fixed box, and the check pops in on the Bootstrap checkbox timing.scaleproperty rather thantransform, since Tailwind v4 emits scale utilities on standalonescaleand leavestransformasnone— namingtransformanimates nothing and the size snaps.h-11 rounded-lg px-5 text-sm md:h-12 md:text-baseinto thexlbutton size. Every hero button already overrode the variant with exactly these, so its ownrounded-md px-7never rendered anywhere.EditHeropinsmd:h-[auto] md:text-smto opt out of the now-responsivexl. It strips sizing with an unqualifiedh-[auto], and tailwind-merge only reconciles utilities sharing a modifier, so that would not have suppressed the newmd:h-12.Worth a look in review: the install button is now a default-variant
Buttonrather than the hand-rolledbg-neutral-900element, and it no longer carries a "Copy to clipboard" tooltip.