CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

performance-engineer

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

Quality

56%

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 skill's front sections (use cases, instructions, safety) are sound but thin, while the bulk of the body is an encyclopedic persona catalog that adds no executable guidance — no commands, profiling recipes, or validation procedures anywhere. It is a monolithic single-file skill whose capability listing should be cut or moved to reference files. Restructuring around concrete how-to content would raise every dimension.

Suggestions

Delete or drastically compress the "Capabilities", "Behavioral Traits", "Knowledge Base", "Purpose", and "Example Interactions" sections — Claude already knows these tools; keep only domain-specific guidance it would not infer.

Replace the abstract Instructions with executable recipes: example profiling commands (e.g., flame graph generation), a sample k6 load test, and a before/after latency comparison methodology with pass/fail criteria.

Add explicit validation checkpoints to the workflow (e.g., "re-run the load test and confirm p99 latency improved ≥X% before/after each change") to satisfy the feedback-loop requirement for load-testing operations.

If detailed tool catalogs are truly needed, move them into references/ files (e.g., references/profiling-tools.md) linked from a short overview, instead of inlining ~95 lines of enumeration.

DimensionReasoningScore

Conciseness

Roughly two-thirds of the body (~120 of 175 lines) is padding Claude does not need: the 11-subsection "Capabilities" catalog enumerating every tool ("DataDog APM, New Relic, Dynatrace, AppDynamics, Honeycomb, Jaeger"), plus "Purpose", "Behavioral Traits", "Knowledge Base", and "Example Interactions" restating what any model knows about performance engineering. This matches anchor 2 (noticeably verbose, several padded sections) rather than anchor 1, because the "Use this skill when", "Do not use", "Instructions", and "Safety" sections do contain real, non-obvious content.

2 / 5

Actionability

The only concrete guidance is the Safety note pointing to current Core Web Vitals definitions and the INP/FID distinction with measurement caveats; everything else is high-level direction ("Collect traces, profiles, and load tests to isolate bottlenecks") with no commands, tool invocations, profiling recipes, or example analyses. This fits anchor 2 (minimal concrete guidance, high-level hints, missing specific steps to execute) and not anchor 3, since there is no partially-executable detail such as example commands or measurement procedures.

2 / 5

Workflow Clarity

Two coherent step sequences exist ("Instructions" 1-4 and "Response Approach" 1-9) with an explicit verification theme ("Verify results and add guardrails", "Validate improvements"), but checkpoints are implicit — no validation commands, comparison methodologies, or error-recovery loops. This matches anchor 3 (sequence present, checkpoints missing/implicit); since load testing is a risky batch-style operation whose verification is only implied, the cap at 3 applies.

3 / 5

Progressive Disclosure

The body has reasonable section structure (Use/Do not use, Instructions, Safety, Limitations), but the ~95-line capability catalog is inline content that belongs in separate reference files or should simply be deleted — no reference files exist at all. This matches anchor 3 (some structure, content that should be separate is inline) rather than anchor 2, because sections are clearly headed and navigable, and the single external link is well-signaled.

3 / 5

Total

10

/

20

Passed

Description

58%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 has a clear 'what' with several concrete, domain-appropriate actions, but lacks any explicit 'use when' trigger clause and misses common natural trigger phrases like 'slow', 'optimize', and 'throughput'. It is distinctive within the performance domain. Adding a trigger clause and natural synonyms would lift both completeness and trigger term quality.

Suggestions

Append an explicit trigger clause, e.g. ". Use when the user reports slow responses, high latency, throughput or capacity problems, or asks to profile, load test, or optimize performance."

Include natural user phrasings and synonyms such as 'slow', 'speed up', 'optimize', 'throughput', and 'scalability' alongside the existing technical terms.

Optionally name one or two concrete artifacts of the work (e.g., flame graphs, SLO/SLI reports) to sharpen specificity toward anchor 5.

DimensionReasoningScore

Specificity

"Diagnose performance bottlenecks using profiling, traces, load tests, and observability; verify latency and capacity improvements" lists several concrete actions (profiling, traces, load tests, observability, verifying latency/capacity), matching anchor 4. It is not anchor 5 because the actions are named at the domain level rather than comprehensively specific (e.g., no concrete output like flame graphs or SLO analysis), and not anchor 3 since more than 1-2 actions are enumerated.

4 / 5

Completeness

The "what" is clear (diagnose bottlenecks via profiling/traces/load tests/observability; verify latency and capacity improvements), but there is no "Use when..." clause or equivalent explicit trigger guidance. Per the rubric guideline, a missing 'when' clause caps completeness at 3, which fits anchor 3 (clear what, when missing or only weakly implied); it is not 4 because no explicit when-guidance exists at all.

3 / 5

Trigger Term Quality

Terms like "performance bottlenecks", "profiling", "traces", "load tests", "latency", and "capacity" are relevant, but common natural variations users would say are missing: "slow", "speed up", "optimize", "throughput", "scalability". This matches anchor 3 (some relevant keywords, missing common variations/synonyms) better than anchor 4, where only a few natural terms would be absent — here several high-frequency user phrasings are absent.

3 / 5

Distinctiveness Conflict Risk

The niche (performance engineering: profiling, load tests, latency/capacity verification) is fairly distinct with domain-specific triggers. It is not anchor 5 because a few closely related skills (observability/monitoring setup, general debugging, capacity planning) share trigger vocabulary like "traces" and "observability"; it is clearly above anchor 3 because the performance-diagnosis framing is specific.

4 / 5

Total

14

/

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.