CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

launchdarkly-flag-discovery

Audit your LaunchDarkly feature flags to understand the landscape, find stale or launched flags, and assess removal readiness. Use when the user asks about flag debt, stale flags, cleanup candidates, flag health, or wants to understand their flag inventory.

Quality

85%

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

86%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, well-structured workflow skill: highly actionable MCP-specific guidance with concrete parameters, defaults, and decision categories, supported by a correctly structured two-file reference bundle. The only notable gaps are minor trimming opportunities and the absence of error-handling guidance for failed or empty tool calls.

Suggestions

Add brief error-recovery guidance (e.g., what to do when a tool call fails, returns empty results, or the projectKey is invalid) to strengthen workflow feedback loops.

Trim interpretive asides like "this tells you the scale of the flag surface area" and "tells a different story than one inactive everywhere" to tighten token efficiency.

DimensionReasoningScore

Conciseness

The body is efficient: it names exact MCP tools, parameters, and defaults without explaining what feature flags or LaunchDarkly are, and the "Important Context" section contains genuinely non-obvious domain facts (e.g., "Weights are scaled by 1000 in the API"). A few interpretive flourishes could be trimmed ("this tells you the scale of the flag surface area", "tells a different story than one inactive everywhere"), which keeps it just below anchor 5's 'every token earns its place' but comfortably above anchor 3's 'some unnecessary explanation'.

4 / 5

Actionability

For an MCP-driven instruction skill, the guidance is fully executable: it specifies exact tool names (`get-flags`, `search-stale-flags`, `get-flag-health`, `get-removal-readiness`), parameter values (`state` of `live`/`deprecated`/`archived`, `inactiveDays` defaults of 30 with conservative/aggressive alternatives of 60/90 and 7/14, `includeOnly` of `temporary`/`all`), returned categories (`never_requested`, `inactive_30d`, `launched_no_changes`), and structured verdicts (`safe`, `caution`, `blocked`). Per the rubric's scoring notes, absence of code in an instruction-only skill is not penalized when the guidance is this concrete.

5 / 5

Workflow Clarity

Six clearly sequenced steps adapt to the user's stated goal, with explicit decision gates in Step 4 ("Don't recommend action without more context") and Step 5 (blocked verdicts "Must resolve first"), plus a checklist delegated to a reference file. This is a read-only discovery skill, so the destructive/batch validation cap does not apply, but there are no error-recovery loops (e.g., what to do when a tool call fails or returns empty results), which keeps it below anchor 5.

4 / 5

Progressive Disclosure

The bundle structure matches the body exactly: both referenced files (`references/flag-health-signals.md`, `references/removal-readiness-checklist.md`) exist, are referenced one level deep at the point of use in Steps 3 and 5 with clear signaling, and are re-listed in a References section. The SKILL.md stays an overview while interpretation detail lives in the references, matching the anchor-5 example of a clear overview with well-signaled one-level-deep references.

5 / 5

Total

18

/

20

Passed

Description

78%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 well-crafted description with an explicit 'Use when' clause carrying multiple natural trigger terms and a concrete statement of capabilities. Its main deductions are the second-person voice ("Audit your... flags"), which the guidelines penalize on specificity, and slight overlap risk with sibling LaunchDarkly skills in the same family.

Suggestions

Rewrite the opening in third person (e.g., "Audits LaunchDarkly feature flags to map the landscape, find stale or launched flags, and assess removal readiness") to avoid the second-person voice penalty.

Broaden trigger coverage with common user phrasings such as "remove flags", "old flags", or "flag cleanup" while keeping the discovery (not action) scope clear.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "find stale or launched flags", "assess removal readiness", "Audit your LaunchDarkly feature flags" — which on its own fits anchor 4 (several specific actions, minor gaps such as flag-health assessment and categorization being only implied). However, it opens in second person ("Audit your LaunchDarkly feature flags") rather than third person, which the judging guidelines penalize by reducing the specificity score by 1, landing it at 3.

3 / 5

Completeness

It explicitly answers both questions: the 'what' is concrete ("Audit your LaunchDarkly feature flags to understand the landscape, find stale or launched flags, and assess removal readiness") and the 'when' is an explicit clause with concrete trigger phrases ("Use when the user asks about flag debt, stale flags, cleanup candidates, flag health, or wants to understand their flag inventory"). This directly matches the anchor-5 example pattern and is clearly better than anchor 4, where the 'when' would be less explicit.

5 / 5

Trigger Term Quality

Strong natural trigger terms: "flag debt", "stale flags", "cleanup candidates", "flag health", "flag inventory", plus the product name "LaunchDarkly" — phrases users would plausibly say. It falls short of anchor 5 because a few natural variations are missing (e.g., "remove/delete flags", "old flags", "flag cleanup"), but it is clearly above anchor 3's 'some relevant keywords, missing common variations'.

4 / 5

Distinctiveness Conflict Risk

The LaunchDarkly-specific framing creates a clear niche, but the skill family includes closely related siblings (flag cleanup, flag targeting), and triggers like "cleanup candidates" and "assess removal readiness" carry minor overlap risk with a dedicated cleanup skill. It fits anchor 4 ('mostly distinct; minor overlap risk with closely related skills') better than anchor 5, whose minimal-conflict example is a standalone skill with fully distinct triggers.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 suspicious

Warning

Total

15

/

16

Passed

Repository

launchdarkly/ai-tooling

Path

skills/feature-flags/launchdarkly-flag-discovery/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.