CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vercel-flags

Vercel Flags guidance — feature flags platform with unified dashboard, Flags Explorer, gradual rollouts, A/B testing, and provider adapters. Use when implementing feature flags, experimentation, or staged rollouts.

58

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/vercel/skills/vercel-flags/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, largely actionable API reference with strong executable examples for flag definition, adapters, and Flags Explorer setup, and an effective 'fetch the docs first' warning for a fast-moving SDK. It is weakened by scattered time-sensitive version/date/pricing details, an incomplete precompute example, and a monolithic single-file layout with no bundle files to offload the setup guides and adapter catalog.

Suggestions

Move time-sensitive details (February 2026 beta status, pricing, v1.0.1/v4.0.3 patch notes) into a dedicated 'Versions & deprecations' or old-patterns section, or drop pricing/marketing lines entirely.

Split the Flags Explorer setup (App + Pages Router) and the provider adapter catalog into reference files (e.g. references/explorer-setup.md, references/adapters.md) and link to them from a leaner overview.

Add a complete precompute example (precompute/serialize/generatePermutations in use) and a one-line verification step for the discovery endpoint (e.g. curl /.well-known/vercel/flags and expect 200).

DimensionReasoningScore

Conciseness

Mostly efficient — the body is dominated by executable code and non-obvious API facts (the CRITICAL fetch-docs note, v4 breaking changes, adapter setup) that Claude genuinely lacks. But it carries time-sensitive material not placed in a deprecated/old-patterns section ('public beta (February 2026)', '$30 per 1 million flag requests', 'v1.0.1 Concurrent Evaluation Fix', 'v4.0.3'), plus mildly promotional filler ('active global replication — changes propagate worldwide in milliseconds'). This matches anchor 3 (mostly efficient with some unnecessary content that could be tightened) rather than 4, given the rubric's explicit penalty for scattered version/date details.

3 / 5

Actionability

Provides concrete, executable TypeScript for the common cases: boolean and multi-variant flag definitions, reading values in Server Components, the vercelAdapter with dedupe identify, and both App Router and Pages Router discovery endpoints with the exact next.config.js rewrite. Minor gaps keep it below anchor 5: the precompute pattern only lists API names ('precompute(), evaluate(), serialize()...') without a working example, and the custom adapter snippet is a skeletal template rather than a copy-paste recipe.

4 / 5

Workflow Clarity

As a reference skill, its setup recipes are well sequenced with concrete steps: define flags → set FLAGS/FLAGS_SECRET env vars → create the discovery endpoint → add the rewrite → deploy (Drafts Workflow bullet), plus a clear 'When to Use' vs 'When NOT to Use' decision table. Anchor 4 (clear sequence with most checkpoints) fits rather than 5 because there are no verification steps — e.g. nothing tells Claude how to confirm the Flags Explorer detects the endpoint — though the skill involves no destructive or batch operations that would demand validation or cap the score.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so all material is inline in a single ~215-line file. Section headers and the closing References list (external URLs) are clear, but sizable blocks that would naturally live in separate reference files — the full Flags Explorer setup for two routers, the provider adapter catalog, and the v4 upgrade notes — are inlined, matching anchor 3 ('content that should be separate is inline') rather than 4, since more than minor reorganization is needed.

3 / 5

Total

14

/

20

Passed

Description

73%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with an explicit 'Use when...' clause, product-specific trigger terms, and a clearly bounded niche. Its main weakness is that 'guidance' is a vague action word — the description enumerates the platform's features rather than the concrete actions the skill performs — and it lacks common synonyms like 'feature toggle'.

Suggestions

Replace the generic action word 'guidance' with concrete verbs, e.g. 'Define and evaluate feature flags with the Flags SDK, configure provider adapters, and set up Flags Explorer.'

Add natural synonyms and variations users say, such as 'feature toggle(s)', 'kill switch', or 'roll out a feature behind a flag', to broaden trigger coverage.

DimensionReasoningScore

Specificity

Names the domain ('Vercel Flags guidance — feature flags platform') and lists concrete feature areas ('unified dashboard, Flags Explorer, gradual rollouts, A/B testing, and provider adapters'), but the only action verb is the generic 'guidance' — it describes the platform's capabilities rather than what the skill concretely does (e.g. define flags, configure adapters, set up the Explorer). This sits at anchor 3 (domain plus 1-2 concrete actions) rather than 4, since the enumerated items are platform features, not performed actions, and it does not reach anchor 2 because the domain naming is specific and informative.

3 / 5

Completeness

Explicitly answers both questions: what ('Vercel Flags guidance — feature flags platform with unified dashboard, Flags Explorer, gradual rollouts, A/B testing, and provider adapters') and when ('Use when implementing feature flags, experimentation, or staged rollouts'). Not anchor 5 because the 'what' is framed as platform description rather than a clear statement of the skill's actions, and not anchor 3 because the 'when' clause is explicit with concrete triggers rather than merely implied.

4 / 5

Trigger Term Quality

Includes natural phrases users would say: 'implementing feature flags', 'A/B testing', 'staged rollouts', 'experimentation'. Missing common synonyms and variations such as 'feature toggle', 'kill switch', 'flag rollout', or package names ('flags', '@flags-sdk'), so it falls just short of anchor 5's comprehensive synonym coverage but is clearly above anchor 3's partial keyword set.

4 / 5

Distinctiveness Conflict Risk

Clear niche — a named product ('Vercel Flags') with distinct, product-specific triggers (dashboard, Flags Explorer, provider adapters). It would not naturally trigger for generic config, environment-variable, or Edge Config work, and the frontmatter path/import patterns reinforce the boundary; minimal conflict risk.

5 / 5

Total

16

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

openai/plugins

Path

plugins/vercel/skills/vercel-flags/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.