Add publishable react-call usage skill for LLMs#101
Merged
Conversation
Ship a consumer-usage agent skill at skills/react-call/ (SKILL.md + references), installable with `npx skills add desko27/react-call --skill react-call`. Broad reach-for trigger, decision/gotcha-oriented, uses the CONTEXT.md glossary, covers v2.x. Add a CI drift guard (packages/react-call/src/__tests__/skill-symbols.test.ts) that fails if the skill imports a react-call export/subpath that no longer exists, and a README "AI agent skill" section with the install command. See docs/adr/0021-publish-consumer-usage-skill.md.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Add a hero link and a [!TIP] callout right after `npm install` so the skill surfaces at setup time, not buried before the v1 migration notes.
Add a copyable `npx skills add` command box under the package InstallCommand on the landing CTA, plus a small CopyCommand component for one-off commands.
Keep the hero link and the dedicated 'AI agent skill' section; remove the callout under npm install.
Add a segmented control above the hero install box that swaps the package InstallCommand (npm/pnpm/yarn/bun) for the agent-skill install command.
- Labels: 'Install' / '🤖 AI skill' - Subtler selector: text with a thin accent underline instead of a bordered pill - No height jump: both boxes share one grid cell, sizing to the taller (lib) box
The grid stack's implicit column was max-content-sized, so the long skill command forced the track wider than the viewport and overflowed. Bound the column with grid-cols-1 (minmax(0,1fr)) and add min-w-0 to the cells so the box caps at the available width and scrolls horizontally inside — matching the install box and the bottom-of-landing command. Verified at 375px.
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
1 participant
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
Ships a publishable, consumer-usage agent skill so LLM coding assistants write correct react-call code. Library users install it into their own project with:
Why
react-call's API is small but has sharp edges an LLM gets wrong without guidance (single-Root rule,
call()being client-only,callvsupsert, mutation flow). A self-contained skill captures the mental model, decision guidance, and gotchas — and stays anchored to the project's canonical vocabulary.Design was settled in a grilling session and recorded in ADR-0021.
Contents
skills/react-call/SKILL.md— broad reach-for trigger + light adoption gate; Declare→Root→Call model,call/upsert/useMutationFlowdecision guide, hard rules, anti-patterns, canonical glossary fromCONTEXT.md. Covers v2.x; defers to the installed version.skills/react-call/references/—mutation-flow.md,host.md,ssr-and-lazy.md,types.md.docs/adr/0021-publish-consumer-usage-skill.md— the publication decision (location,--skillpin, single broad skill, GitHub-not-npm distribution, drift guard).packages/react-call/src/__tests__/skill-symbols.test.ts) — fails the build if the skill imports areact-callexport or subpath that no longer exists. Operating rule: API-breaking changes update the skill in the same PR.AI agent skillsection + TOC entry with the install command.Key decisions (per ADR-0021)
skills/, not.agents/skills/— keeps it out of discovery space shared with the maintainers' vendored workflow skills; the documented--skill react-callpin installs exactly one.npx skillsresolves from GitHub and pins by commit/hash.Validation
pnpm lint✅ ·pnpm check:types✅ ·pnpm test✅ (137/137)Follow-up
main, confirm discovery end-to-end withnpx skills add desko27/react-call --list.