CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

performance-profiling

Performance profiling principles. Measurement, analysis, and optimization techniques.

Quality

55%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

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

Quality

Content

53%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 lean, well-organized set of reference tables with one genuinely executable script, but most tables restate knowledge Claude already has and offer little concrete executable guidance beyond that script. The 4-step workflow is clearly sequenced, yet its validation checkpoints remain implicit with no error-recovery loop.

Suggestions

Trim tables that restate well-known reference data (Core Web Vitals thresholds, DevTools tab purposes, generic quick wins) and keep only project-specific guidance — the thresholds and tool mappings Claude already knows cost tokens without adding skill value.

Add executable commands beyond the single Lighthouse script — e.g., the actual bundle-analyzer invocation and how to capture/export a DevTools Performance profile in headless or CLI form.

Expand the 4-step workflow with concrete validation checkpoints: which metric defines the baseline, what threshold counts as an improvement, and an explicit fix-and-re-measure loop when validation fails.

DimensionReasoningScore

Conciseness

The body is compact tables with no prose padding, but a substantial share restates stable knowledge Claude already has — 'LCP | < 2.5s', 'INP | < 200ms', 'CLS | < 0.1' are published Core Web Vitals thresholds, and the DevTools tool-selection and 'Optimize images / Enable compression' quick-win tables are generic common knowledge. This fits 'mostly efficient but includes some unnecessary explanation'; not score 4 because several sections add no information beyond what Claude knows.

3 / 5

Actionability

There is exactly one executable command ('python scripts/lighthouse_audit.py https://example.com'), which is copy-paste ready, but everything else is abstract mapping tables — 'Slow initial load | Large JS, render blocking', 'Big library | Import specific modules', 'Long tasks (>50ms) | UI blocking' — with no commands, code, or concrete steps for using DevTools or a bundle analyzer. Fits 'some concrete guidance but incomplete'; not score 2 because the script invocation and usage table are concrete, not score 4 because no other executable guidance exists.

3 / 5

Workflow Clarity

The '4-Step Process' (BASELINE → IDENTIFY → FIX → VALIDATE) is a clear ordered sequence and names validation, but the checkpoints are implicit: no instruction on how to measure the baseline, which metric or threshold confirms improvement, or what to do when validation fails (no fix-and-retry loop). This matches 'steps listed but validation gaps; checkpoints missing or implicit'; not score 4 because the validation step carries no executable detail.

3 / 5

Progressive Disclosure

The body is organized into seven numbered sections with clear headers, and the only bundle file (scripts/lighthouse_audit.py, verified to exist) is correctly referenced with purpose and usage in a table — good structure with content appropriately inline at this size. Not score 5 because the trailing 'When to Use' section ('This skill is applicable to execute the workflow or actions described in the overview') is vague filler placed after the closing note, and the reference-style lookup tables could be signaled toward separate reference files as the skill grows.

4 / 5

Total

13

/

20

Passed

Description

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

The description names a recognizable domain but provides no concrete capabilities and no 'use when' trigger guidance, leaving completeness and specificity weak. Its keywords are category words rather than the phrases a user would naturally say when they need profiling help.

Suggestions

Add a 'Use when...' clause with concrete triggers, e.g., 'Use when a page loads slowly, Lighthouse or Core Web Vitals scores are poor, bundle size is large, or interactions feel janky.'

Replace the generic noun list with concrete capabilities, e.g., 'Runs Lighthouse audits, profiles runtime and memory in DevTools, and analyzes bundle composition.'

Include natural user phrasings and synonyms — 'slow page', 'page speed', 'web vitals', 'bundle size', 'Lighthouse score' — so the skill triggers on the words users actually say.

DimensionReasoningScore

Specificity

The description names the domain ('Performance profiling principles') but offers only generic noun categories ('Measurement, analysis, and optimization techniques') with no concrete actions or objects — matching the anchor 'Names the domain but actions are minimal or generic' ('Processes PDF files'). Not score 3 because there are no concrete verb-object capabilities (e.g., 'Runs Lighthouse audits, profiles runtime and memory, analyzes bundle size').

2 / 5

Completeness

The 'what' is vague ('principles' and 'techniques' with no stated capabilities) and there is no 'when' at all — no 'Use when...' clause or equivalent trigger guidance, which also caps this dimension at 3 per the judging guidelines. This matches 'Has a vague what and no when'; not score 3 because the what never states what the skill actually does, only abstract topic categories.

2 / 5

Trigger Term Quality

'Performance profiling' is a phrase a user would naturally say, but coverage stops there — missing natural variations and synonyms like 'slow page', 'page speed', 'Lighthouse', 'Core Web Vitals', 'bundle size', or 'jank'. Fits 'Some relevant keywords but missing common variations or synonyms'; not score 4 because keyword coverage is a single narrow phrase with no file extensions, tool names, or colloquial variants.

3 / 5

Distinctiveness Conflict Risk

'Performance profiling' is a somewhat specific niche, but with no trigger guidance and only generic category words, it could overlap with general code-optimization, debugging, or monitoring skills. Fits 'Somewhat specific but could still overlap with similar skills'; not score 4 because overlap risk with adjacent optimization skills is more than minor given the absence of distinguishing triggers.

3 / 5

Total

10

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

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