CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

feature-flags

Declare, evaluate, manage, and remove framework feature flags. Use when shipping a capability gradually, targeting users or organizations, or replacing a compile-time rollout switch with a production-safe runtime flag.

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

This is a high-quality, actionable skill body: complete code for every workflow step, explicit validation checkpoints, and concentrated project-specific knowledge with almost no generic filler. The remaining room is in trimming two peripheral narratives and splitting detailed contract material into reference files.

Suggestions

Trim the historical registry-bug explanation in the Register section to the constraint plus a one-line reason, cutting the module-local-map backstory.

Move the reversible experience-presets contract (or the rollout-semantics edge-case detail) into a references/ file and signal it from SKILL.md to keep the overview lean.

Add a short useFeatureFlagState code snippet so the loading-state pattern is as executable as the other steps.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious project knowledge (the barrel-import Vite crash, the globalThis registry rationale, fail-closed hook semantics) and avoids generic concept explanations, but the historical registry-bug narrative and the experience-presets section run slightly long and could be trimmed.

4 / 5

Actionability

Every core workflow step has complete, executable TypeScript (defineFeatureFlag declaration, createFeatureFlagsPlugin registration, isFeatureFlagEnabled server guard, useFeatureFlag hook) plus a concrete Analytics UI path, an actions table, and exact API shapes for useFeatureFlagState — copy-paste ready and covering the common cases.

5 / 5

Workflow Clarity

The Declare → Register → Guard → Verify-and-rollout sequence is explicit, validation is front-loaded ("Verify the off path before changing rollout state", step 5 agreement check), a ten-item verification checklist covers every rollout path, and flag removal is a numbered five-step workflow with its own verification step.

5 / 5

Progressive Disclosure

Sections are clean and well-ordered with no buried references, but at roughly 190 lines with no bundle files, detailed material such as rollout-semantics edge behavior and the reversible experience-presets contract could be split into clearly signaled one-level-deep reference files.

4 / 5

Total

18

/

20

Passed

Description

92%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: it covers the full flag lifecycle with concrete verbs and pairs them with an explicit, multi-trigger "Use when" clause in third-person voice. The only gap is missing common synonyms (e.g., "feature toggle") that would broaden natural trigger coverage.

DimensionReasoningScore

Specificity

The description lists four concrete lifecycle actions — "Declare, evaluate, manage, and remove framework feature flags" — giving comprehensive coverage of the domain rather than the minor-gaps profile of a 4.

5 / 5

Completeness

Both halves are explicit: the "what" is the four lifecycle verbs, and the "when" gives three concrete triggers ("Use when shipping a capability gradually, targeting users or organizations, or replacing a compile-time rollout switch with a production-safe runtime flag").

5 / 5

Trigger Term Quality

Natural phrases like "feature flags", "shipping a capability gradually", "targeting users or organizations", and "compile-time rollout switch" are present, but common synonyms such as "feature toggle" or "kill switch" are missing, so coverage is good rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — framework feature flags with a control-plane rollout model — and its triggers (gradual shipping, user/org targeting, replacing a compile-time switch) are unlikely to fire for unrelated skills.

5 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation — 13 / 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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

BuilderIO/agent-native

Path

.agents/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.