Content
86%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |