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.

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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-engineered skill body: executable commands with real flags, four workflows with genuine validation gates (including on the destructive cleanup path), and clean progressive disclosure to real, substantive bundle files. The only weakness is mild token padding in the framing and script-logic re-descriptions that could be trimmed.

DimensionReasoningScore

Conciseness

The body is dense and domain-specific (taxonomy table, provider trade-offs, detection heuristics — none of it concepts Claude already knows), but the pitch-style intro ('Most teams treat flags as throwaway if-statements'), the re-description of each script's internal logic, and summary tables that partially duplicate references/* keep it below 'every token earns its place'. It is well above anchor 3's 'noticeably verbose' — the padding is minor, not systematic.

4 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: Quick start and per-tool sections give concrete `python scripts/...` invocations with real argument values (--max-age-days 90, --strategy ring, --flag-doc docs/feature-flags.md), and all three scripts exist in the bundle and are stdlib Python as claimed. Specific examples cover the common cases (audit, plan, audit-kill-switch).

5 / 5

Workflow Clarity

The four workflows are clearly sequenced with 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', and the destructive cleanup workflow re-runs the audit afterward ('should now show one fewer flag'). Even the risky deletion path has owner-confirmation and re-audit steps, matching anchor 5.

5 / 5

Progressive Disclosure

A clear overview with well-signaled one-level-deep references: all 4 references/, 3 scripts/, and the asset file exist and are non-trivial (65–171 lines each), each is annotated in a dedicated References section plus inline pointers ('See references/flag_taxonomy.md for decision tree'), and summary tables are kept inline with detail deferred to the reference files. Navigation is easy and nothing is nested two levels deep.

5 / 5

Total

19

/

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 that leads with an explicit 'Use when' clause, enumerates concrete capabilities and tooling, and packs in a dozen natural trigger terms including all major vendor names. The only gap is a few common synonyms (feature toggle, A/B test, canary) that would broaden trigger coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — 'adding, retiring, or auditing feature flags', 'Ships flag debt scanner, rollout planner, and kill-switch auditor (all stdlib Python)', plus a '/flag-cleanup slash command' — covering the full flag lifecycle. It matches the anchor-5 example's comprehensiveness; anchor 4 ('minor gaps in coverage') fits less well since add/audit/retire plus tooling spans the domain.

5 / 5

Completeness

It explicitly answers both questions: 'Use when adding, retiring, or auditing feature flags' (when, with concrete trigger phrases) and a clear what (debt scanner, rollout planner, kill-switch auditor, 4 references, slash command). This mirrors the anchor-5 example's structure; anchor 4's 'when could be more explicit' does not apply since the trigger clause leads the description.

5 / 5

Trigger Term Quality

Twelve explicit natural triggers ('add a flag', 'ship behind a flag', 'rollout plan', 'kill switch', 'stale flags', 'flag debt', 'LaunchDarkly', 'GrowthBook', 'Statsig', 'Unleash', 'Flipt', 'progressive-delivery') far exceed the anchor-4 example, but common synonyms a user would naturally say — 'feature toggle', 'A/B test', 'canary release/dark launch' — are missing, so it falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche (feature-flag lifecycle / progressive delivery) with distinct triggers including five provider names; there is no plausible adjacent skill these triggers would misfire into. Anchor 4's 'minor overlap risk with closely related skills' is not evidenced.

5 / 5

Total

19

/

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