CtrlK
BlogDocsLog inGet started
Tessl Logo

performance-optimization

Optimizes application performance. Use when performance requirements exist, when you suspect performance regressions, or when Core Web Vitals or load times need improvement. Use when profiling reveals bottlenecks that need fixing.

59

Quality

67%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/performance-optimization/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

57%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description has strong completeness with explicit 'Use when' clauses covering multiple trigger scenarios, but it is severely lacking in specificity of concrete actions. The 'what' portion is essentially a single vague phrase ('Optimizes application performance') without listing any specific techniques or operations. Adding concrete actions and more natural trigger terms would significantly improve this description.

Suggestions

Replace the vague 'Optimizes application performance' with specific concrete actions, e.g., 'Reduces bundle sizes, implements lazy loading, optimizes rendering paths, improves caching strategies, and minimizes network requests.'

Add more natural trigger terms users would say, such as 'slow page', 'lighthouse score', 'LCP', 'FCP', 'TTI', 'latency', 'rendering performance', or 'page speed'.

Narrow the scope to distinguish from related skills (e.g., specify 'web application front-end performance' vs general application performance) to reduce conflict risk.

DimensionReasoningScore

Specificity

The description says 'Optimizes application performance' which is vague and abstract. It does not list any concrete actions like 'minify JavaScript', 'lazy-load images', 'reduce bundle size', or 'optimize database queries'. The only specific term mentioned is 'Core Web Vitals' but that describes a trigger, not an action.

1 / 3

Completeness

The description answers both 'what' (optimizes application performance) and 'when' with explicit trigger clauses: 'Use when performance requirements exist, when you suspect performance regressions, or when Core Web Vitals or load times need improvement. Use when profiling reveals bottlenecks.' Both parts are present and explicit.

3 / 3

Trigger Term Quality

Includes some relevant keywords like 'performance', 'Core Web Vitals', 'load times', 'profiling', and 'bottlenecks' which users might naturally say. However, it's missing common variations like 'slow page', 'latency', 'rendering', 'bundle size', 'lighthouse score', 'FCP', 'LCP', 'TTI', or 'optimization'.

2 / 3

Distinctiveness Conflict Risk

While 'Core Web Vitals' and 'load times' add some specificity, 'optimizes application performance' is broad enough to overlap with many skills (e.g., database optimization, code refactoring, caching strategies). The domain of 'application performance' is not narrowly scoped enough to avoid conflicts.

2 / 3

Total

8

/

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 strong, actionable performance optimization skill with excellent workflow structure and concrete code examples. Its main weakness is length — the document tries to be both an overview and a detailed reference, which hurts conciseness and progressive disclosure. The diagnostic decision tree and BAD/GOOD code contrasts are particularly effective teaching tools.

Suggestions

Move the detailed anti-pattern code examples (N+1 queries, image optimization, React re-renders, caching, bundle splitting) into a separate reference file to keep SKILL.md as a concise overview with the workflow and decision tree.

Remove or significantly trim the 'Common Rationalizations' table — it's motivational content that doesn't help Claude execute performance optimization tasks.

DimensionReasoningScore

Conciseness

The skill is generally well-structured but includes some content Claude already knows (e.g., the 'Common Rationalizations' table is motivational rather than actionable, the 'When NOT to use' explanation is somewhat obvious). The image optimization example is extremely verbose with the full <picture> element covering every permutation. The decision tree and anti-pattern examples are valuable, but the overall document could be tightened by ~30%.

2 / 3

Actionability

The skill provides fully executable code examples across multiple domains: N+1 query fixes, React memoization, caching patterns, image optimization HTML, bundle splitting, and CI enforcement commands. The diagnostic decision tree is concrete and directly maps symptoms to investigation steps. Code examples are copy-paste ready with clear BAD/GOOD contrasts.

3 / 3

Workflow Clarity

The 5-step optimization workflow (Measure → Identify → Fix → Verify → Guard) is clearly sequenced with explicit validation checkpoints. Step 4 (Verify) requires measuring again to confirm improvement, and Step 5 (Guard) adds regression prevention. The verification checklist at the end provides a concrete feedback loop. The diagnostic decision tree adds excellent structure for the identification step.

3 / 3

Progressive Disclosure

The skill references `references/performance-checklist.md` for detailed checklists, but no bundle files are provided to verify this exists. The main document is quite long (~250+ lines) with extensive inline code examples that could be split into separate reference files (e.g., frontend anti-patterns, backend anti-patterns). The structure within the file is good with clear sections, but the content density suggests it would benefit from more aggressive splitting.

2 / 3

Total

10

/

12

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.

Validation11 / 11 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.