Skip to content

[services] Add Vercel Services skill - #134

Merged
Melkeydev merged 10 commits into
mainfrom
ricardo/add-vercel-services-skill
Aug 7, 2026
Merged

[services] Add Vercel Services skill#134
Melkeydev merged 10 commits into
mainfrom
ricardo/add-vercel-services-skill

Conversation

@ricardo-agz

@ricardo-agz ricardo-agz commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Adds a vercel-services skill for building multi-service applications on Vercel with services

@ricardo-agz
ricardo-agz marked this pull request as draft August 6, 2026 03:08
ricardo-agz and others added 5 commits August 5, 2026 20:29
Lead with when Services is the right call (tightly coupled frontend +
backend in one project) and its concrete benefits: skew protection,
synced previews, atomic deploys and rollbacks, private bindings. The
separate-projects escape hatch is now about independent deploy cadence.

Drop framework pinning from examples, add /api namespace-split guidance
(SPA vs frameworks with their own API routes), prefix stripping via
service-scoped rewrite, SPA catch-all to /index.html, and a subdomain
section with the preview-environment caveat.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The proxy only reads destination.service when dispatching into a
service; the path field is compiled and validated but never consumed
at request time.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
No top-level rewrite means a service is unreachable from the public
internet and only accessible through bindings; adding a rewrite makes
it public regardless of bindings.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@ricardo-agz
ricardo-agz marked this pull request as ready for review August 7, 2026 01:00
@ricardo-agz
ricardo-agz requested a review from Melkeydev August 7, 2026 01:01
Comment thread generated/skill-manifest.json Outdated
Comment thread generated/skill-manifest.json Outdated
Comment thread generated/skill-manifest.json Outdated
ricardo-agz and others added 4 commits August 6, 2026 23:26
Review feedback: the frontend term made the group miss backend-led
phrasings. The wider [backend, vercel] group can reach the threshold
with anyOf hits, which we accept for now.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Intents: one line per job the skill teaches, anchored by domain
vocabulary (services, binding, rewrites, vercel.json) rather than
product-name prefixes, and covering the private-by-default, subdomain,
and prefix-stripping content added in this PR.

Examples: verbatim-style prompts carrying stack names (FastAPI, Vite,
Express, Go) and symptom phrasings, which is what the lowest-weight
retrieval field is for.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Removed 'frontend' from the 'anyOf' array in skill manifest.
The manifest is generated from SKILL.md, so removing the term only
from generated/skill-manifest.json left the two out of sync and
failed the manifest check.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@Melkeydev
Melkeydev merged commit 12d0770 into main Aug 7, 2026
4 checks passed
@Melkeydev
Melkeydev deleted the ricardo/add-vercel-services-skill branch August 7, 2026 18:19
@1st1

1st1 commented Aug 7, 2026

Copy link
Copy Markdown
Member

@Melkeydev the hip shooter of vercel.. my main feedback -- too many words, I'd do a pass for brevity.

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.

4 participants