CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

73

Quality

92%

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

85%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 strong, highly actionable body: runnable commands, explicit workflows with validation gates, and concrete heuristics. The main defects are a broken bundle — none of the nine referenced files or scripts actually ship — and inline material (provider table, taxonomy, strategy detail) that belongs in those missing references, plus minor framing verbosity.

Suggestions

Ship the referenced bundle files: references/flag_taxonomy.md, references/provider_comparison.md, references/rollout_strategies.md, references/flag_lifecycle.md, scripts/flag_debt_scanner.py, scripts/rollout_planner.py, scripts/kill_switch_audit.py, and assets/flag_request_template.md are all cited in SKILL.md but absent from the bundle, so every referenced path is a dead link.

Move the full provider comparison table and per-provider rows into references/provider_comparison.md, keeping only the decision rules inline, and trim the framing sentences (e.g., 'Most teams treat flags as throwaway `if`-statements...', 'Different flag types have different lifespans and ownership.') to tighten the token budget.

Verify the script invocations match the shipped scripts' actual argument names (--max-age-days, --min-uses, --strategy ring, etc.) once the scripts are added, so the copy-paste commands in Quick start and the tool sections execute as written.

DimensionReasoningScore

Conciseness

Largely efficient — command blocks, tables, and workflows are dense and actionable — but there are trimmable spots: framing sentences like 'Most teams treat flags as throwaway `if`-statements' and 'Different flag types have different lifespans and ownership. Misclassifying creates debt', and a full provider table plus decision rules that duplicate what references/provider_comparison.md is meant to carry. Matches the score-4 anchor (minor over-explanation that could be trimmed); not 5 because several sentences and the inlined provider detail do not earn their tokens, and not 3 because none of it is generic textbook explanation Claude already knows.

4 / 5

Actionability

Fully executable, copy-paste-ready invocations for all three tools with concrete flags ('python scripts/flag_debt_scanner.py --repo . --max-age-days 90 --format json > debt.json'), explicit detection heuristics, defined rollout strategies with phase ladders (1% → 5% → 25% → 50% → 100%), and anti-patterns stated as recognizable code smells. Matches the score-5 anchor; a 4 would require missing key details, and none of the common cases lack a runnable example.

5 / 5

Workflow Clarity

Four workflows with clear numbered sequences and explicit validation checkpoints and feedback loops: 'Run kill_switch_audit.py — must pass before merge', 'Deploy at 0%; verify kill switch works', 'abort if abort criteria met', 'Test the kill switch in staging BEFORE production rollout', and the destructive cleanup workflow gates each removal on confirming 100% rollout and owner agreement. Matches the score-5 anchor; not 4 because every risky step (merge, deploy, deletion) has an explicit checkpoint rather than a minor gap.

5 / 5

Progressive Disclosure

The SKILL.md body itself is well sectioned and signals its references clearly (a References section listing four files with one-line descriptions), but scored against the actual bundle: every cited path — 4 references/*.md, 3 scripts/*.py, and assets/flag_request_template.md — is missing from the bundle, and substantial content that those files should carry (the full provider comparison table, taxonomy detail, strategy definitions) is inlined in SKILL.md. This fits the score-3 anchor ('some structure... content that should be separate is inline'); it is not 4/5 because the one-level-deep reference chain points at files that do not exist, and not 2 because the body's own structure is clear and references are explicitly signaled rather than buried.

3 / 5

Total

17

/

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.

Excellent description: third-person, dense, and explicit. It states exactly what the skill ships (three stdlib tools, four references, a slash command) and when to invoke it, with a rich set of natural trigger phrases and provider names that make false-positive triggering unlikely.

DimensionReasoningScore

Specificity

Names multiple concrete deliverables: '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' — comprehensive and specific, matching the score-5 anchor. It is not a 4 because coverage spans tools, references, and a command with no gaps; not below 5 because there is no generic filler language.

5 / 5

Completeness

Explicitly answers 'when' with a 'Use when adding, retiring, or auditing feature flags' clause plus a concrete 'Triggers on...' list, and 'what' with the enumerated tools, references, and slash command — exactly the score-5 anchor's what+when with concrete trigger phrases. A 4 would apply only if the when-clause were weaker or implicit, which it is not.

5 / 5

Trigger Term Quality

Comprehensive natural trigger phrases users would actually say: 'add a flag', 'ship behind a flag', 'rollout plan', 'kill switch', 'stale flags', 'flag debt', plus all five provider names (LaunchDarkly, GrowthBook, Statsig, Unleash, Flipt) and the umbrella term 'progressive-delivery'. Matches the score-5 anchor (synonyms and variations covered); no common phrasing for this domain is missing, so 4 would undersell it.

5 / 5

Distinctiveness Conflict Risk

Clear niche (feature-flag lifecycle management) with distinct triggers including vendor-specific product names, so it is unlikely to fire for an unrelated skill. Matches the score-5 'clear niche with distinct triggers' anchor; it is not a 4 because the trigger set is vendor-anchored and domain-unique rather than merely 'mostly distinct'.

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

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 17 missing

Warning

Total

14

/

16

Passed

Repository
alirezarezvani/claude-skills
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.