Skip to content

skills(flags-sdk): trigger on any feature-flag task and route by stack - #554

Merged
vincent-derks merged 1 commit into
mainfrom
skills/flags-sdk-broader-triggers
Oct 13, 2026
Merged

vincent-derks merged 1 commit into
mainfrom
skills/flags-sdk-broader-triggers

Conversation

@roboeve

@roboeve roboeve Bot commented Oct 13, 2026 •

Copy link
Copy Markdown
Contributor

Broadens the flags-sdk skill description so agents load it for any feature-flag task, and adds a short section that picks the right integration for the project's stack.

Why

Agents pick a skill by reading its description. The current one opens with "the Flags SDK (flags npm package)" and spends most of its ~990 characters (close to the 1024-character limit) listing CLI subcommands and provider names. When someone asks to "put this behind a flag", "add a kill switch", or "roll this out to 10% of users", especially outside Next.js or SvelteKit or before picking a library, the description doesn't obviously match, so the skill isn't loaded.

Once loaded, the body also assumes Next.js or SvelteKit. The guidance for other frameworks (@vercel/flags-core) is buried in references/providers.md.

Approach

Because the description is the only trigger signal, rewriting it around user intent should get the skill loaded for more flag-related requests:

  • The new description (~480 characters) leads with intent: planning, adding, or changing flags, toggles, kill switches, experiments, and percentage rollouts in any app or framework, even before a provider is chosen.
  • It still names the key entities (Vercel Flags, Flags SDK, @vercel/flags-core, OpenFeature, provider adapters, Flags Explorer, vercel flags CLI). The full subcommand list is left to the body and to vercel flags --help.
  • A new Choose an approach section follows the SDKs comparison: Flags SDK for Next.js and SvelteKit, @vercel/flags-core for other frameworks, OpenFeature for provider portability. It also says to keep an existing provider and connect it through its adapter.

The skill name is unchanged.

Validation

  • Markdown-only change. The new links point to existing docs pages and to the existing Core client in other frameworks heading in references/providers.md.
  • No em dashes added. Frontmatter is still a folded YAML block.

Relevant context

vercel/vercel-plugin syncs this skill body into skills/flags-sdk/upstream/ and keeps its own frontmatter in overlay.yaml. A companion PR, vercel/vercel-plugin#334, updates the overlay description to match. The body change will reach the plugin on its next resync.

@vercel

vercel Bot commented Oct 13, 2026 •

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
flags-playground Ready Ready Preview, v0 Oct 13, 2026 2:53pm UTC
flags-sdk-dev Ready Ready Preview, v0 Oct 13, 2026 2:53pm UTC
flags-sdk-flagsmith Ready Ready Preview, v0 Oct 13, 2026 2:53pm UTC
flags-sdk-growthbook Ready Ready Preview, v0 Oct 13, 2026 2:53pm UTC
flags-sdk-launchdarkly Ready Ready Preview, v0 Oct 13, 2026 2:53pm UTC
flags-sdk-openfeature Ready Ready Preview, v0 Oct 13, 2026 2:53pm UTC
flags-sdk-posthog Ready Ready Preview, v0 Oct 13, 2026 2:53pm UTC
flags-sdk-reflag Ready Ready Preview, v0 Oct 13, 2026 2:53pm UTC
flags-sdk-snippets Ready Ready Preview, v0 Oct 13, 2026 2:53pm UTC
flags-sdk-statsig Ready Ready Preview, v0 Oct 13, 2026 2:53pm UTC
flags-sdk-sveltekit-snippets Ready Ready Preview, v0 Oct 13, 2026 2:53pm UTC
shirt-shop Ready Ready Preview, v0 Oct 13, 2026 2:53pm UTC
shirt-shop-api Ready Ready Preview, v0 Oct 13, 2026 2:53pm UTC

@vincent-derks
vincent-derks marked this pull request as ready for review October 13, 2026 15:30
@vincent-derks
vincent-derks merged commit 98c1548 into main Oct 13, 2026
30 checks passed
@vincent-derks
vincent-derks deleted the skills/flags-sdk-broader-triggers branch October 13, 2026 15:31

This branch was successfully deployed

14 active deployments
Preview – flags-sdk-dev — f7c765b2 Deployed Oct 13, 2026 by vercel[bot]
Preview – flags-sdk-vercel — f7c765b2 Deployed Oct 13, 2026 by vercel[bot]
Preview – flags-sdk-launchdarkly — f7c765b2 Deployed Oct 13, 2026 by vercel[bot]
Preview – flags-sdk-flagsmith — f7c765b2 Deployed Oct 13, 2026 by vercel[bot]
Preview – flags-sdk-growthbook — f7c765b2 Deployed Oct 13, 2026 by vercel[bot]
Preview – flags-sdk-statsig — f7c765b2 Deployed Oct 13, 2026 by vercel[bot]
Preview – flags-sdk-reflag — f7c765b2 Deployed Oct 13, 2026 by vercel[bot]
Preview – flags-playground — f7c765b2 Deployed Oct 13, 2026 by vercel[bot]
Preview – flags-sdk-snippets — f7c765b2 Deployed Oct 13, 2026 by vercel[bot]
Preview – flags-sdk-sveltekit-snippets — f7c765b2 Deployed Oct 13, 2026 by vercel[bot]
Preview – flags-sdk-posthog — f7c765b2 Deployed Oct 13, 2026 by vercel[bot]
Preview – flags-sdk-openfeature — f7c765b2 Deployed Oct 13, 2026 by vercel[bot]
Preview – shirt-shop-api — f7c765b2 Deployed Oct 13, 2026 by vercel[bot]
Preview – shirt-shop — f7c765b2 Deployed Oct 13, 2026 by vercel[bot]
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