CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

feature-flags

Use when: implementing, creating, testing, or debugging feature flags in Primer React. Covers useFeatureFlag hook, FeatureFlags provider, DefaultFeatureFlags, FeatureFlagScope, Storybook integration, and the feature flag lifecycle at GitHub.

Quality

88%

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

The canonical home for this skill is feature-flags in primer/react

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 high-quality, executable reference for the Primer React feature-flag system: concrete code for every task, a clear lifecycle, and pointers to authoritative source files instead of duplicated lists. Its only weaknesses are a small amount of concept padding, a partly redundant Patterns section, and no explicit validate/re-verify checkpoints in the lifecycle.

Suggestions

Cut the opening paragraph explaining what feature flags are generally for — Claude already knows this — and trim the 'Patterns' section, which restates the hook usage already shown in 'How to Use'.

Add an explicit verification checkpoint in the lifecycle, e.g., after registering a flag, confirm the export resolves and both enabled/disabled tests pass before shipping.

Consider moving 'Real Codebase Examples' and 'FeatureFlags Provider Internals' into a references/ file to keep the main SKILL.md as a lean overview.

DimensionReasoningScore

Conciseness

The body is dense and almost entirely non-obvious specifics (file paths, export entry point caveat, naming conventions, env-var wiring), but has minor trims available: the opening sentence explains what feature flags are ('help build confidence in changes and improve the reliability of releases'), a concept Claude already knows, and the 'Patterns' section partially repeats the 'How to Use' hook example. This fits 'efficient; minor instances of over-explanation' rather than the lean anchor above.

4 / 5

Actionability

Every section gives copy-paste-ready code: flag registration in DefaultFeatureFlags, useFeatureFlag usage, test wrappers with the FeatureFlags provider, Storybook story examples, and real codebase snippets with exact file paths (e.g., packages/react/src/AnchoredOverlay/AnchoredOverlay.tsx). Specific examples cover all the common cases, matching the 'fully executable; copy-paste ready' anchor.

5 / 5

Workflow Clarity

The feature flag lifecycle is a clearly sequenced 6-step list (Create → Implement → Test in Storybook → Ship → Enable at GitHub → Remove), reinforced by a numbered 'How to Use' walkthrough and a warning to set the flag back to false before merging in Dotcom CI. Checkpoints are mostly implicit (test both states, revert before merge) rather than explicit validate-and-retry loops, fitting 'clear sequence with most checkpoints; minor validation gaps'. No destructive/batch operation cap applies.

4 / 5

Progressive Disclosure

No bundle files exist, so everything is in SKILL.md; it is well-sectioned and, instead of duplicating a stale flag list, points to the source of truth ('Check packages/react/src/FeatureFlags/DefaultFeatureFlags.ts for the current list'). Minor organization gaps keep it below the top anchor: 'Real Codebase Examples' and 'FeatureFlags Provider Internals' could live in reference files, and at ~200 lines the body is at the upper bound of what belongs in a main file. Fits 'good structure; most content appropriately placed; minor organization gaps'.

4 / 5

Total

17

/

20

Passed

Description

87%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: explicit 'Use when' triggers, third-person voice, a concrete coverage list of named APIs, and a tightly scoped Primer React/GitHub niche. Only minor improvements possible around synonym coverage and naming the flag-removal step as an action.

Suggestions

Add common natural variations users might say, such as 'toggle', 'rollout', or 'kill switch', to broaden trigger-term coverage.

Mention flag removal/cleanup (part of the lifecycle) as an explicit capability to close the small coverage gap in specificity.

DimensionReasoningScore

Specificity

Concrete actions are named ('implementing, creating, testing, or debugging feature flags') alongside specific covered entities (useFeatureFlag hook, FeatureFlags provider, DefaultFeatureFlags, FeatureFlagScope, Storybook integration). It lists several specific capabilities with only minor gaps (e.g., flag removal/cleanup is not named as an action), matching the 'several specific actions; minor gaps' anchor rather than the fully comprehensive anchor above.

4 / 5

Completeness

Both questions are answered explicitly: 'Use when: implementing, creating, testing, or debugging feature flags in Primer React' gives concrete when-triggers, and 'Covers useFeatureFlag hook, FeatureFlags provider, DefaultFeatureFlags, FeatureFlagScope, Storybook integration, and the feature flag lifecycle at GitHub' states the what concretely. It clearly matches the 'explicitly answers both what AND when with concrete trigger phrases' anchor.

5 / 5

Trigger Term Quality

Natural terms users would say are present ('feature flags', 'Primer React', 'Storybook integration', 'testing', 'debugging') plus component names a developer would search for. A few common variations are missing (e.g., 'toggle', 'rollout', 'flag naming'), so it fits 'good keyword coverage; a few natural terms missing' rather than the comprehensive-synonym anchor.

4 / 5

Distinctiveness Conflict Risk

The description is pinned to a clear niche — feature flags specifically in Primer React — with distinct trigger phrases and named APIs, so it is unlikely to fire for unrelated flag, React, or Storybook skills. It matches the 'clear niche with distinct triggers; minimal conflict risk' anchor.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

primer/react

Path

.agent/skills/feature-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.