MUST be used whenever fixing performance issues in a Flows app. This skill finds AND fixes performance problems — re-renders, inefficient queries, missing pagination, unbounded fetches, large bundles, and memory leaks. It does not just report them. Always measure before and after. Triggers: performance, slow, laggy, optimize, re-render, bundle size, load time, CDF query, large list, memory leak, debounce, virtualize, lazy load, code split.
70
88%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that excels across all dimensions. It clearly defines its scope (performance issues in Flows apps), lists specific concrete problems it addresses, explicitly states when it should be used with a mandatory directive, and provides an extensive list of natural trigger terms. The description is concise yet comprehensive, avoiding vague language while covering both the 'what' and 'when' thoroughly.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and problem types: re-renders, inefficient queries, missing pagination, unbounded fetches, large bundles, memory leaks. Also specifies it 'finds AND fixes' and 'measures before and after' — these are concrete, actionable behaviors. | 3 / 3 |
Completeness | Clearly answers both 'what' (finds and fixes performance problems including re-renders, inefficient queries, missing pagination, etc.) and 'when' ('MUST be used whenever fixing performance issues in a Flows app' plus explicit trigger terms). The 'Use when' equivalent is strongly stated upfront. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'performance', 'slow', 'laggy', 'optimize', 're-render', 'bundle size', 'load time', 'memory leak', 'debounce', 'virtualize', 'lazy load', 'code split'. These are terms a developer would naturally use when experiencing performance issues. | 3 / 3 |
Distinctiveness Conflict Risk | Scoped specifically to 'Flows app' performance issues, which is a clear niche. The combination of domain (Flows app) and task type (performance optimization) with specific technical triggers like 'CDF query', 'virtualize', 'code split' makes it highly distinctive and unlikely to conflict with general coding or debugging skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a highly actionable and well-structured performance optimization skill with excellent workflow clarity — the measure-first/measure-after methodology and systematic grep-based discovery approach are strong. The main weakness is its length; at 400+ lines in a single file with no bundle support, it could benefit from splitting detailed fix patterns into referenced files to improve token efficiency and progressive disclosure.
Suggestions
Extract detailed fix patterns (virtualization, debounce hook, bundle analysis setup) into separate reference files (e.g., PATTERNS.md, BUNDLE-ANALYSIS.md) and reference them from the main skill to reduce token cost
Remove explanations of concepts Claude already knows, such as why lodash is large, what moment.js alternatives exist, or how AbortController works — just show the transformation pattern
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is thorough and mostly efficient, but at ~400+ lines it includes some redundancy (e.g., repeated table summaries restating what the code examples already show, the debounce hook implementation that Claude could write). Some sections like the lodash/moment replacements explain things Claude already knows. However, given the breadth of the skill, most content earns its place. | 2 / 3 |
Actionability | Every step provides concrete, executable code examples with clear BAD/FIX patterns, specific grep commands to find issues, and copy-paste ready solutions. The skill consistently shows both the anti-pattern and the exact fix to apply, with real SDK call signatures and library imports. | 3 / 3 |
Workflow Clarity | The 11-step workflow is clearly sequenced with an explicit measure-first/measure-after methodology (Steps 1 and 11). Each step includes specific grep commands to find issues, concrete fix patterns, and the final step requires reporting deltas with a template table. The feedback loop of baseline → fix → re-measure is well-enforced, and the instruction to not fabricate numbers adds a validation checkpoint. | 3 / 3 |
Progressive Disclosure | The content is a monolithic document with no references to supporting files (no bundle files exist). At 400+ lines, some sections (e.g., the full virtualization pattern, the debounce hook implementation, the bundle analysis setup/teardown) could be split into referenced files. The single reference to 'semantic-knowledge/ directory if available' is appropriately handled, but the overall document would benefit from splitting detailed patterns into separate reference files. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
72%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 8 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (526 lines); consider splitting into references/ and linking | Warning |
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
metadata_version | 'metadata.version' is missing | Warning |
Total | 8 / 11 Passed | |
d6af887
Table of Contents
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.