CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

performance-engineer

Diagnose performance bottlenecks using profiling, traces, load tests, and observability; verify latency and capacity improvements.

47

Quality

59%

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-engineer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a persona-style capability catalog: well-sectioned but verbose, with heavy tool-name enumeration that adds little beyond what Claude already knows, no concrete commands or examples, and two overlapping step sequences with implicit validation. It would benefit most from radical trimming and executable specifics.

Suggestions

Cut the "Capabilities", "Knowledge Base", "Behavioral Traits", and "Example Interactions" catalogs — Claude already knows these tools; keep only non-obvious guidance such as tool-selection heuristics or known pitfalls.

Add concrete executable examples (e.g., a k6 load-test snippet, a perf/py-spy profiling command, a flame-graph triage recipe) so the guidance goes beyond high-level direction.

Merge "Instructions" and "Response Approach" into one sequenced workflow with explicit validation checkpoints and error-recovery loops (e.g., re-profile when the fix fails to move the target metric).

DimensionReasoningScore

Conciseness

Roughly two-thirds of the body is padded enumeration Claude already knows: ~100 lines of tool catalogs under "Capabilities" ("DataDog APM, New Relic, Dynatrace, AppDynamics, Honeycomb, Jaeger"; "Redis, Memcached, Hazelcast"), plus largely redundant "Purpose", "Behavioral Traits", "Knowledge Base", and "Example Interactions" sections restating the same scope. It sits between anchor 1 (severely padded) and anchor 3 (mostly efficient): clearly below the midpoint because the padding dominates, but it does not explain basic concepts in prose, so 2 fits.

2 / 5

Actionability

There is no executable code, command, or concrete tool invocation anywhere — guidance is high-level ("Collect traces, profiles, and load tests to isolate bottlenecks", "Implements caching at appropriate layers"). This matches anchor 2 (minimal concrete guidance; high-level hints missing specific steps) rather than anchor 1, because the Instructions and Response Approach sections do give a usable high-level direction rather than pure description.

2 / 5

Workflow Clarity

Two parallel step lists ("Instructions" 4 steps and "Response Approach" 9 steps) define a coherent baseline → bottleneck → optimize → verify → monitor sequence, and "Verify results and add guardrails" plus the Safety section acknowledge validation. However, checkpoints are implicit with no error-recovery loops (e.g., what to do when a load test contradicts the profile), and the duplicated sequences create ambiguity, matching anchor 3 (steps listed but validation gaps) rather than anchor 4.

3 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so everything lives in SKILL.md. Section headers give real structure, but the ~100-line capability catalog is exactly the inline reference material that belongs in separate files, matching anchor 3 (some structure; content that should be separate is inline). It is above anchor 2 because the document is well-sectioned and navigable, not a headerless wall of text.

3 / 5

Total

10

/

20

Passed

Description

66%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 concise, concrete description with good domain-specific trigger terms and low conflict risk. Its main weakness is the absence of an explicit "Use when..." clause, which caps completeness and leaves invocation guidance implicit.

Suggestions

Append an explicit trigger clause, e.g., "Use when the user reports slowness, needs load testing, profiling, or capacity planning, or asks to optimize latency or throughput."

Add natural user synonyms such as "slow", "speed up", "throughput", or "optimize" to broaden trigger-term coverage.

Consider mentioning concrete artifacts users bring (e.g., flame graphs, APM dashboards, k6 scripts) to sharpen distinctiveness.

DimensionReasoningScore

Specificity

The description names the domain (performance) and several concrete techniques — "Diagnose performance bottlenecks using profiling, traces, load tests, and observability; verify latency and capacity improvements" — with two concrete action verbs (diagnose, verify). It falls between anchor 3 (1-2 concrete actions, not comprehensive) and anchor 5 (multiple specific actions, comprehensive): broader than a single action but thinner than the anchor-5 example, so 4 fits.

4 / 5

Completeness

The "what" is clear (diagnose bottlenecks, verify latency/capacity improvements), but there is no "Use when..." clause or equivalent explicit trigger guidance — the "when" is only weakly implied by the domain terms. Per the judging guidelines, a missing explicit trigger clause caps completeness at 3; it is not 2 because the "what" is specific rather than vague.

3 / 5

Trigger Term Quality

Natural phrases a user would say include "performance bottlenecks", "profiling", "traces", "load tests", "latency", and "capacity" — good coverage of the domain vocabulary. It misses common user synonyms like "slow", "speed up", "optimize", or "throughput", which keeps it below the anchor-5 comprehensive-synonym bar but comfortably above anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

The diagnosis/verification framing with profiling, traces, and load tests carves a fairly distinct performance-engineering niche. Minor overlap risk remains with closely related skills (e.g., general debugging, frontend optimization, or database tuning), so it matches anchor 4 rather than the minimal-conflict profile of anchor 5.

4 / 5

Total

15

/

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

sickn33/agentic-awesome-skills

Path

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