Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill body is highly actionable and well-sequenced with strong validation safeguards for a destructive batch operation. Its main weakness is redundancy between the workflow steps and the closing 'Important notes' section.
Suggestions
Trim the 'Important notes' section to only net-new caveats (e.g. seasonal flags, experiment flags) and remove points already stated in the workflow like 'Code first, then disable' to reduce token redundancy.
Shorten the example interaction or reference it as a representative subset rather than re-rendering the full cleanup prompt already shown in step 3.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean and domain-specific, but the 'Important notes' section reiterates points already made in the workflow (e.g. 'Code first, then disable' repeats step 4's 'Never disable flags before the code changes are deployed') and the example interaction is lengthy, so it could be tightened. | 2 / 3 |
Actionability | Copy-paste-ready cleanup blocks with specific search terms (isFeatureEnabled, useFeatureFlag, etc.), exact tool names and parameters (posthog:feature-flag-get-all with active: "STALE"), and per-rollout-state instructions make the guidance fully executable. | 3 / 3 |
Workflow Clarity | A clear four-step sequence (list, assess, generate cleanup, disable) with explicit checkpoints and feedback loops — 'Never disable flags before the code changes are deployed', 'confirm each action', and the cleanup instructions doubling as an approval checklist — gives the destructive batch operation proper validation. | 3 / 3 |
Progressive Disclosure | No bundle files exist, and the self-contained content is organized into well-labeled sections (When to use, What makes a flag stale, Workflow, Example, Important notes, Related tools) with easy header-based navigation, so a single well-structured file is appropriate here. | 3 / 3 |
Total | 11 / 12 Passed |