CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

feature-flags-architect

Use when adding, retiring, or auditing feature flags. Triggers on "add a flag", "ship behind a flag", "rollout plan", "kill switch", "stale flags", "flag debt", "LaunchDarkly", "GrowthBook", "Statsig", "Unleash", "Flipt", or any progressive-delivery question. Ships flag debt scanner, rollout planner, and kill-switch auditor (all stdlib Python), 4 references on flag taxonomy + provider trade-offs + rollout strategies + lifecycle, plus a /flag-cleanup slash command.

75

Quality

94%

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-architect in alirezarezvani/claude-skills

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.

A well-executed skill body: concrete commands, four clearly sequenced workflows with real validation gates, and a clean one-level-deep reference structure that matches the actual bundle. The only weaknesses are mild duplication between the inline tables and the reference files, and an advertised /flag-cleanup slash command with no backing file in the bundle.

Suggestions

Either add the commands/flag-cleanup.md file (or inline definition) that backs the advertised '/flag-cleanup' slash command, or remove the claim from both the body and the description.

Trim the provider chooser table to the decision rules only and defer pricing/lock-in columns to references/provider_comparison.md to cut duplication and stale-pricing risk.

The taxonomy table could drop the 'Cleanup trigger' column in favor of a pointer to references/flag_taxonomy.md, whose decision tree already covers ownership and lifespan.

DimensionReasoningScore

Conciseness

The body is dominated by executable commands, tables, and terse workflows with almost no explanation of concepts Claude already knows (e.g., 'Walk --repo for code references matching common flag-call patterns'). Minor trimming is possible: the provider chooser table's pricing/lock-in columns overlap with references/provider_comparison.md, and the taxonomy table restates material from references/flag_taxonomy.md.

4 / 5

Actionability

Every tool ships copy-paste-ready invocations with real flags ('python scripts/flag_debt_scanner.py --repo . --max-age-days 90 --format json > debt.json', three rollout_planner variants per strategy), plus concrete decision rules ('<50 flags + no targeting → DIY with config file or env vars') and named detection patterns. Specific examples cover the common cases across all three scripts.

5 / 5

Workflow Clarity

All four workflows are numbered with explicit validation checkpoints and abort/recovery loops: Workflow 1 gates merging on 'Run kill_switch_audit.py — must pass before merge', verifies at 0%, and includes 'abort if abort criteria met'; Workflow 2 confirms each flag reached 100% and re-audits ('should now show one fewer flag'); Workflow 4 requires testing the kill switch in staging before production. These match the anchor's feedback loops and checklists.

5 / 5

Progressive Disclosure

Good structure: the body is an overview with a References section clearly signaling all four one-level-deep reference files (all verified present), plus scripts/ and assets/ that exist as claimed. Minor gap: the '/flag-cleanup' slash command is described ('Run the full cleanup workflow on the current repo') but no commands/ file or definition backs it anywhere in the bundle, and the two summary tables partially duplicate reference content rather than purely pointing to it.

4 / 5

Total

18

/

20

Passed

Description

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

An exemplary description: third-person, concise, explicit 'Use when' clause with concrete trigger phrases and provider names, and a precise inventory of what the skill bundle contains. Every dimension lands at the top anchor; the only nit is that a common synonym like 'feature toggle' is absent from the trigger list.

DimensionReasoningScore

Specificity

Concrete actions are named directly ('adding, retiring, or auditing feature flags') and the deliverables are enumerated precisely ('Ships flag debt scanner, rollout planner, and kill-switch auditor (all stdlib Python), 4 references on flag taxonomy + provider trade-offs + rollout strategies + lifecycle'). This matches the top anchor's multiple specific concrete actions with comprehensive coverage, and the third-person voice ('Ships...') avoids the person penalty.

5 / 5

Completeness

It explicitly answers both questions: 'when' opens the description ('Use when adding, retiring, or auditing feature flags. Triggers on...') with concrete trigger phrases, and 'what' closes it ('Ships flag debt scanner, rollout planner, and kill-switch auditor... plus a /flag-cleanup slash command'). This matches the anchor example's pattern of both what and when with concrete triggers.

5 / 5

Trigger Term Quality

Coverage is comprehensive across natural phrases users would actually say ('add a flag', 'ship behind a flag', 'rollout plan', 'kill switch', 'stale flags', 'flag debt'), the five provider product names (LaunchDarkly, GrowthBook, Statsig, Unleash, Flipt), and the category term 'any progressive-delivery question'. This exceeds the top anchor's synonym coverage; common variants like 'feature toggle' are absent but the breadth of phrases plus product names makes the top anchor the best fit rather than the 'a few natural terms missing' anchor below it.

5 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — feature flag lifecycle management with named providers (LaunchDarkly, GrowthBook, Statsig, Unleash, Flipt) — and triggers like 'kill switch', 'flag debt', and provider names are unlikely to fire for a different skill. Minimal conflict risk, matching the top anchor.

5 / 5

Total

20

/

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_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

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

engineering/skills/feature-flags-architect/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.