CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

performance-optimization

Optimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.

Quality

81%

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

73%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 well-engineered workflow skill with an explicit five-step process, genuine measurement discipline, and textbook per-pattern progressive disclosure into a real reference file. Its weaknesses are repetition across the Rationalizations/Red Flags/Verification sections and a dangling reference to a performance-checklist.md that is not in the bundle.

Suggestions

Consolidate the revert-neutral rule to a single authoritative statement: the Rationalizations rows, Red Flag, and Verification checkboxes that repeat it can be cut, saving roughly 40-60 lines.

Fix or remove the dangling '../../references/performance-checklist.md' reference (cited in 'See Also' and Missing caching) — either ship the file in the bundle or point to a path that resolves.

Make the backend measurement section executable like the frontend one — e.g. a concrete query-timing snippet or a specific APM/profiler command instead of comment-only placeholders.

DimensionReasoningScore

Conciseness

Most sections earn their tokens with non-obvious expertise (pool sizing via 'instances × max', EXPLAIN ANALYZE signature reading, cache stampede coalescing), but the revert-neutral rule is restated roughly five times — the Step 4 decision table, its own paragraph ('Neutral is a revert, not a keep'), two Rationalizations rows ('It didn't help much, but it doesn't hurt', 'The improvement is obvious, no need to re-measure'), a Red Flag, and two Verification checkboxes — and Red Flags/Verification largely restate Step 3 rules. More than 'minor' trimming, yet far from anchor 2's padded verbosity.

3 / 5

Actionability

Largely executable: runnable web-vitals imports, console.time timing, copy-paste CI commands ('npx bundlesize --config bundlesize.config.json', 'npx --package=@lhci/cli lhci autorun' with the correct scoped-package caveat), numeric budgets, and a symptom→action decision tree. It misses anchor 5 because the backend measurement code block contains only comments ('Response time logging', 'Application Performance Monitoring (APM)') rather than executable guidance, and no concrete profiling commands are given.

4 / 5

Workflow Clarity

The Measure→Identify→Fix→Verify→Guard sequence is explicit with strong validation: 'Re-measure the way you measured the baseline: same command, same conditions', noise comparison ('A 3% gain inside ±5% variance is not a gain'), a strict keep/revert decision table, a feedback loop ('When either guard fires, return to Step 1 and establish a fresh baseline'), and a final checklist — a direct match for anchor 5.

5 / 5

Progressive Disclosure

Excellent one-level-deep structure: each anti-pattern links to a verified heading in references/optimization-patterns.md ('Open the one you need when you reach that code, not before'), and all anchors resolve. It misses anchor 5 because '../../references/performance-checklist.md' is cited twice (See Also and Missing caching) but does not exist in the bundle, breaking navigation.

4 / 5

Total

16

/

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 with an explicit, multi-clause 'Use when...' trigger set and clear domain scoping. Its main weakness is that the capability statement rests on a single generic verb ('optimizes') rather than naming concrete actions, and it omits the everyday words users most often say ('slow', 'latency', 'faster').

Suggestions

Replace the single generic verb with 2-3 concrete capabilities, e.g. 'Profiles and fixes performance bottlenecks: speeds up slow queries, reduces bundle size, improves Core Web Vitals'.

Add the natural phrasings users actually say — 'slow', 'latency', 'load time', 'speed up', 'faster' — to the trigger list.

DimensionReasoningScore

Specificity

The only action stated is the generic verb 'Optimizes application performance across frontend, backend, queries, and databases' — one action scoped across four areas, closer to anchor 2's 'Processes PDF files' than to a list of several concrete actions. The concrete when-scenarios ('N+1 query patterns need fixing', 'Core Web Vitals or load times need improvement') lift it above anchor 2, but it never enumerates multiple specific actions, so anchor 4 is out of reach.

3 / 5

Completeness

Explicitly answers both questions: what ('Optimizes application performance across frontend, backend, queries, and databases') and when, via a five-clause 'Use when...' sentence with concrete trigger phrases ('when you suspect performance regressions', 'when profiling reveals bottlenecks'). This is a direct match for anchor 5; anchor 4's weaker 'when' does not apply.

5 / 5

Trigger Term Quality

Includes natural, likely-spoken terms — 'performance regressions', 'Core Web Vitals', 'load times', 'N+1 query patterns', 'profiling', 'bottlenecks' — which is good coverage matching anchor 4. It falls short of anchor 5 because common user phrasings like 'slow', 'latency', 'speed up', and 'faster' are absent.

4 / 5

Distinctiveness Conflict Risk

The performance-specific triggers (Core Web Vitals, N+1 queries, profiling) carve a clear niche, but the deliberately broad scope 'across frontend, backend, queries, and databases' creates minor overlap with closely related frontend-tuning or database-tuning skills — anchor 4 rather than anchor 5's 'minimal conflict risk'.

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

addyosmani/agent-skills

Path

skills/performance-optimization/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.