CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

66

Quality

78%

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

A highly actionable, well-sequenced optimization workflow with excellent validation discipline, undermined by verbosity from re-teaching fundamentals inline and by a broken external reference. Moving the detailed fix catalog and long markup examples into the (currently missing) referenced file would improve both token efficiency and progressive disclosure.

Suggestions

Create the referenced references/performance-checklist.md (the path is cited twice but no such file exists in the bundle) and move the deep-dive material there — the full <picture> markup, the React re-render and code-splitting basics, and the cache implementation details — leaving SKILL.md as a lean overview of the workflow, thresholds, and decision tables.

Trim sections that restate knowledge Claude already has (React.memo/useMemo semantics, route-level lazy loading, hand-rolled TTL caching) down to one-line pointers or the decision table alone; the ~495-line body could roughly halve without losing any non-obvious judgment.

Make the remaining examples fully copy-paste ready: replace the comment-only synthetic-measurement block and the `db.query(...)` / `res.set` fragments with concrete runnable snippets, and include the bundlesize.config.json contents alongside the `npx bundlesize` command.

DimensionReasoningScore

Conciseness

The body runs ~495 lines and, while much of it is non-obvious judgment (EXPLAIN ANALYZE interpretation, pool sizing, cache stampede handling), several sections re-teach fundamentals Claude already knows: React.memo/useMemo basics, route-level code splitting, a full 50-line <picture> element example, and a hand-rolled TTL cache. This matches the 3 anchor (mostly efficient with some unnecessary explanation); it is not 4 because the padding is more than minor and not 2 because the majority of sections do earn their tokens.

3 / 5

Actionability

Extensive concrete guidance: executable SQL (EXPLAIN ANALYZE, CREATE INDEX), TypeScript fixes, symptom→cause→investigation tables, a symptom decision tree, and CI commands (npx bundlesize, npx lhci autorun). Minor gaps keep it below the 5 anchor: the synthetic-measurement bash block is comments only, `db.query(...)` and the `res.set` fragment are illustrative rather than copy-paste ready, and bundlesize.config.json is referenced but not shown.

4 / 5

Workflow Clarity

The MEASURE→IDENTIFY→FIX→VERIFY→GUARD workflow is explicitly sequenced with a dedicated validation step: re-measure under identical conditions, compare deltas against noise, a strict keep/revert decision table, correctness gates, a reverted-attempt ledger, and a final checklist. Feedback loops are present (revert on neutral/worse, return to Step 1 when a guard fires), matching the 5 anchor.

5 / 5

Progressive Disclosure

Section structure and headers are good, but the body is a ~495-line monolith with deep detail (the full picture-element markup, the complete anti-pattern fix catalog) inlined that belongs in a separate reference file, and the only external pointer — `../../references/performance-checklist.md`, cited twice — does not exist anywhere in the bundle (no references/ directory). This matches the 3 anchor (content that should be separate is inline; references not backed by real files); it is not 2 because navigation within the body itself is well organized.

3 / 5

Total

15

/

20

Passed

Description

87%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 trigger list and a clearly stated scope across frontend, backend, queries, and databases. The main improvement opportunity is adding a couple more concrete action verbs and common synonyms like "slow" or "latency" to broaden natural-trigger matching.

DimensionReasoningScore

Specificity

The description names four concrete domains ("frontend, backend, queries, and databases") and specific patterns ("N+1 query patterns", "Core Web Vitals"), but the capability side rests on a single generic verb ("Optimizes"), so it sits between the 3 anchor (1-2 concrete actions) and the 5 anchor (multiple specific actions) — noticeably above the midpoint. Not 5 because it never states distinct actions like profile, fix, or re-measure.

4 / 5

Completeness

Clearly answers both: what it does ("Optimizes application performance across frontend, backend, queries, and databases") and when to use it via an explicit five-clause "Use when..." with concrete trigger phrases. This matches the 5 anchor exactly; the 4 anchor would require a less explicit 'when', which is not the case.

5 / 5

Trigger Term Quality

Strong natural phrases users would say: "performance requirements", "performance regressions", "Core Web Vitals", "load times", "N+1 query patterns", "profiling reveals bottlenecks". Missing common synonyms such as "slow", "latency", "speed up", or "throttling", which keeps it below the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Performance optimization is a clear niche and the triggers (Core Web Vitals, N+1 queries, profiling bottlenecks) are distinctive to it, giving minimal conflict risk. The 4 anchor's "minor overlap risk" would apply if it shared triggers with closely related skills (e.g., a dedicated database-tuning skill), but the stated scope explicitly claims those areas as performance work.

5 / 5

Total

18

/

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