CtrlK
BlogDocsLog inGet started
Tessl Logo

optimizing-performance

Analyzes and optimizes application performance across frontend, backend, and database layers. Use when diagnosing slowness, improving load times, optimizing queries, reducing bundle size, or when asked about performance issues.

63

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/optimizing-performance/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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.

The skill has an excellent measure-optimize-re-measure workflow with explicit validation, feedback loops, and checklists, plus concrete profiling commands and code examples. Its weaknesses are token efficiency (many examples re-teach patterns Claude already knows) and structure (a ~236-line monolith that should split optimization catalogs and target tables into reference files).

Suggestions

Trim or remove examples of patterns Claude already knows well (React memo/useMemo, N+1-to-JOIN, O(n^2)-to-Set duplicates, lodash named imports); keep only project-specific or non-obvious guidance such as the layered cache strategy.

Split the frontend/backend optimization catalogs and the Web Vitals/API target tables into one-level-deep reference files (e.g., references/frontend.md, references/targets.md), leaving SKILL.md as a workflow overview.

Make the caching and queue snippets more self-contained by specifying the assumed libraries (e.g., node-cache/lru-cache, BullMQ) and cache TTL/eviction details.

DimensionReasoningScore

Conciseness

The body is code-heavy rather than padded prose, but a substantial share of the examples teach concepts Claude already knows well — React memo/useMemo usage, the N+1 query JOIN fix, O(n^2)-to-Set duplicate finding, lodash direct vs. named imports. These "mostly efficient but includes some unnecessary content" sections could be trimmed or cut, matching anchor 3; a 2 would require genuinely explanatory padding, and a 4 would leave only minor trimmable bits.

3 / 5

Actionability

Concrete, runnable commands ("node --prof app.js", "python -m cProfile -o profile.stats app.py", "lighthouse https://example.com --output=json") and copy-paste-ready SQL/JS/HTML snippets cover the common cases. Score 4 rather than 5 because several snippets reference undefined context ("memoryCache", "queue", "app", "db", "redis") and the memoryCache layer lacks TTL/eviction specifics, leaving minor gaps.

4 / 5

Workflow Clarity

The five-step loop is explicit and tracked via a copyable checklist, fronted by "Never optimize without data. Always profile before and after changes", includes a Step 4 re-measure comparison checklist, a validation checklist, and the feedback loop "If targets not met, return to Step 2 and identify remaining bottlenecks" — matching the anchor for clear sequence with explicit validation, feedback loops, and checklists.

5 / 5

Progressive Disclosure

Sections are clearly organized (When to Load, Steps 1-5, targets tables, validation), but at ~236 lines the optimization catalogs (frontend/backend/algorithm patterns, Web Vitals and API target tables) are inline content that would fit better in one-level-deep reference files. This matches anchor 3 — some structure, but content that should be separate is inline; not a 2 because nothing is buried and navigation is easy.

3 / 5

Total

15

/

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 strong description that clearly states what the skill does and when to use it, with natural, well-chosen trigger phrases spanning frontend, backend, and database concerns. The main weakness is that the capability statement relies on generic verbs rather than enumerating specific actions, and a few common synonyms (profiling, latency, speed up) are absent.

Suggestions

Replace the generic "Analyzes and optimizes" with 2-3 concrete actions, e.g., "Profiles applications, identifies bottlenecks, and applies optimizations across frontend, backend, and database layers".

Add common trigger synonyms such as "profiling", "latency", or "making the app faster" to broaden natural-language matching.

DimensionReasoningScore

Specificity

"Analyzes and optimizes application performance across frontend, backend, and database layers" names the domain clearly but the actions are the two generic verbs "analyzes" and "optimizes" — comparable to "Processes PDF files and extracts content". A score of 4 would require several distinct concrete actions (e.g., profiling, query analysis, bundle auditing), and 2 would lack the layer scoping that is present.

3 / 5

Completeness

Both parts are explicit: the "what" ("Analyzes and optimizes application performance across frontend, backend, and database layers") and a "Use when..." clause with multiple concrete triggers. This matches the anchor "clearly and explicitly answers both what AND when with concrete trigger phrases"; a 4 would have a weaker or less specific "when".

5 / 5

Trigger Term Quality

"diagnosing slowness, improving load times, optimizing queries, reducing bundle size, or when asked about performance issues" are natural phrases users would say, with good coverage across layers. Not a 5 because common synonyms like "profiling", "latency", "slow app", or "speed up" are missing.

4 / 5

Distinctiveness Conflict Risk

The performance-optimization niche is mostly distinct with performance-specific triggers, but "optimizing queries" and the frontend/backend/database breadth carry minor overlap risk with dedicated database or framework skills. Not a 5 because the three-layer scope is broad rather than a tight niche.

4 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
CloudAI-X/claude-workflow-v2
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.