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.

68

Quality

85%

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

81%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 disciplined, measurement-first workflow with strong validation gates, explicit keep/revert decision rules, and a closing checklist, backed by a well-organized anchored pattern reference. The weak spots are comment-only backend measurement guidance and a twice-referenced checklist file that does not exist in the provided bundle.

Suggestions

Replace the backend Step 1 comment placeholders (APM, query timing) with one executable example, such as a slow-query-log command or a timing middleware snippet, matching the concreteness of the frontend measurement block.

Resolve the `../../references/performance-checklist.md` path: either ship the file inside the skill's references/ directory or drop/inline its two mentions so no link in the bundle dangles.

DimensionReasoningScore

Conciseness

Largely token-efficient — symptom→cause tables, a symptom decision tree, and numeric budgets carry the content, and worked fixes are pushed to the reference file. Minor over-explanation remains in Step 4's motivational prose ("This is the step teams skip: the change is already written, throwing it away feels wasteful...") and in Common Rationalizations rows that restate Step 3 bullets ("The query is slow, add an index", "Just cache it"). Not 5 because a few passages could be trimmed without losing guidance; not 3 because the padding is minor relative to the dense signal.

4 / 5

Actionability

Mostly executable — copy-paste `import { onLCP, onINP, onCLS } from 'web-vitals'`, `npx bundlesize --config bundlesize.config.json`, `npx lhci autorun`, concrete `EXPLAIN ANALYZE` plan-reading guidance, numeric budgets, and a strict keep/revert decision table. Not 5: the backend Step 1 block is comment placeholders ("Response time logging / Application Performance Monitoring (APM)") with no runnable command, and some Step 3 entries are rules rather than examples. Anchor 4 (concrete code with minor gaps) is the best fit.

4 / 5

Workflow Clarity

Clear five-step sequence (MEASURE → IDENTIFY → FIX → VERIFY → GUARD) with explicit validation: "Re-measure the way you measured the baseline: same command, same conditions, same fixed budget", a keep-or-revert decision table gated on tests staying green, a feedback loop ("When either guard fires, return to Step 1 and establish a fresh baseline"), and a 13-item verification checklist. Direct match to anchor 5 (explicit validation, feedback loops, checklist).

5 / 5

Progressive Disclosure

SKILL.md keeps worked fixes in a well-signaled, one-level-deep reference file ("links to a worked fix in references/optimization-patterns.md... Open the one you need when you reach that code, not before"), and all 8 anchored links (n1-queries-backend, unbounded-data-fetching, queries-that-ignore-their-index, connection-pool-exhaustion, missing-caching-backend, missing-image-optimization-frontend, unnecessary-re-renders-react, large-bundle-size) resolve to real sections in the bundle. Not 5 because `../../references/performance-checklist.md` is referenced twice (Step 3 caching entry and the See Also section) yet is absent from the bundle — a dangling navigation target that leaves the skill directory.

4 / 5

Total

17

/

20

Passed

Description

82%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 a clear what, an explicit multi-trigger when-clause, and distinctive domain terminology in correct third-person voice. Its only weakness is the what-clause, which names a single verb and scope rather than enumerating the skill's concrete actions.

Suggestions

Enumerate concrete actions in the what-clause — e.g., "Profiles bottlenecks, fixes N+1 queries, reduces bundle size, and tunes indexes, caching, and connection pools" — to raise specificity.

Add common user phrasings such as "slow", "latency", or "response times" to the trigger list so it matches how users naturally report performance problems.

DimensionReasoningScore

Specificity

The what-clause — "Optimizes application performance across frontend, backend, queries, and databases" — names the domain and a single action. Concrete actions appear only inside the when-clause ("N+1 query patterns need fixing"), so it matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than anchor 4, which requires several specific listed actions such as "profiles bottlenecks, fixes N+1 queries, reduces bundle size".

3 / 5

Completeness

Explicitly answers both: what ("Optimizes application performance across frontend, backend, queries, and databases") and when, via an explicit "Use when..." clause with four concrete triggers ("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"). Matches anchor 5; the when-clause is more explicit than anchor 4's example, so 4 would understate it.

5 / 5

Trigger Term Quality

Good coverage of natural terms users would say: "performance regressions", "Core Web Vitals", "load times", "N+1 query patterns", "profiling", "bottlenecks". Common variations like "slow", "latency", "response times", or "speed up" are absent, so anchor 4 (good coverage, a few natural terms missing) fits better than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

A clear performance-tuning niche with distinctive triggers (Core Web Vitals, N+1 query patterns, profiling, bottlenecks) unlikely to fire for unrelated skills, and correct third-person voice ("Optimizes") with no first/second-person penalty. Anchor 5 (clear niche, minimal conflict risk) is the best fit; adjacent skills like a generic database skill would not claim these triggers.

5 / 5

Total

17

/

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.