CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

performance-optimization

Measure, diagnose, and improve a performance or capacity objective?latency, throughput, CPU, memory, scalability, or cost?without regressing correctness. Use when performance is the primary requested outcome. Do not use for generic code cleanup or an unmeasured incident postmortem.

Quality

81%

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

73%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 well-engineered, evidence-first skill with an excellent sequenced workflow, explicit validation checkpoints, and a concrete output contract. The main deductions are triple-stated activation/routing guidance that inflates token cost, and dangling references to a shared policy framework that is not actually packaged in the bundle.

Suggestions

Consolidate the activation guidance: the trigger-phrase list in "Purpose and activation" and the "Routing Boundary" section both restate the frontmatter description's activation conditions — keep one authoritative routing section and cut the duplicate.

Fix or remove the dangling `shared/base/*.md` and `shared/workflow-contract.md` links — ten linked paths do not exist in the bundle, so a reader following the "Required packaged policies" instruction cannot load them.

Trim the "Tooling and portability" tool-name enumerations (pprof, perf, Lighthouse, etc.) to the few that change decisions, or move them into the domain reference files, and reference `scripts/validate_scenarios.py` from the output-contract section since it statically validates the required report sections.

DimensionReasoningScore

Conciseness

The body is dense and mostly non-padded, but activation guidance is stated three times (frontmatter description, "Purpose and activation" trigger list, and "Routing Boundary"), and sections like "Tooling and portability" enumerate tools Claude already knows (pprof, perf, Lighthouse, OpenTelemetry). This matches the 'mostly efficient but includes some unnecessary explanation or could be tightened' anchor; it is not the 4 anchor because the redundancy across activation sections is more than minor.

3 / 5

Actionability

Concrete, executable guidance is prevalent: exact commands (`EXPLAIN (ANALYZE, BUFFERS)`, `pg_stat_statements`), a symptom-to-investigation pattern table, a required output contract with a defined table schema, and specific directives (define SLO, capture p50/p95/p99, classify observations as Verified/Likely/Hypothesis). Some directives remain abstract ("Rank hypotheses by expected user impact, confidence, reversibility"), so it fits the 'mostly executable guidance with minor gaps' anchor rather than fully copy-paste-ready at 5.

4 / 5

Workflow Clarity

The five-step workflow (frame/baseline, locate limiting resource, inspect layers, design/implement, benchmark/validate/roll out) has explicit validation checkpoints: re-measure after every material change, evidence classification with confidence labels, a completion checklist, before/after benchmark criteria, and predefined abort thresholds with rollback. This matches the 5 anchor's clear sequence with explicit validation steps, feedback loops, and a checklist for a complex process.

5 / 5

Progressive Disclosure

Domain detail is appropriately split into five well-signaled, one-level-deep reference files that all exist in the bundle (e.g. "Read [database-and-cache.md](references/database-and-cache.md)"), matching good structure. However, the "Required packaged policies" section links nine `shared/base/*.md` files plus `shared/workflow-contract.md` that do not exist in the bundle, and `scripts/validate_scenarios.py` is present but never referenced — organization gaps that keep this below the 5 anchor's 'clear overview with well-signaled references'.

4 / 5

Total

16

/

20

Passed

Description

83%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: third-person voice, concrete actions, a comprehensive objective list, an explicit Use when clause, and negative boundaries that reduce conflict risk. Its only weakness is that the activation criterion is stated as a condition rather than concrete trigger phrases users would naturally say.

DimensionReasoningScore

Specificity

"Measure, diagnose, and improve" names three concrete actions, and the objective space is comprehensively enumerated ("latency, throughput, CPU, memory, scalability, or cost") with an explicit correctness constraint ("without regressing correctness"). This matches the anchor for multiple specific concrete actions with comprehensive coverage, exceeding the 4 anchor which only expects several actions with minor gaps.

5 / 5

Completeness

Both parts are present: the what ("Measure, diagnose, and improve a performance or capacity objective ... without regressing correctness") and an explicit when ("Use when performance is the primary requested outcome") plus a do-not-use boundary. The when-clause is a condition rather than concrete user trigger phrases (e.g. "optimize performance", "why is this slow"), so it fits the 4 anchor ('when' could be more explicit or specific) rather than the 5 anchor requiring concrete trigger phrases.

4 / 5

Trigger Term Quality

Natural keywords present include performance, latency, throughput, CPU, memory, scalability, and cost, which users commonly say. However, frequent natural phrasings like "optimize", "profile", "speed up", "slow", "benchmark", and "response time" are absent from the description, matching the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive-synonyms anchor at 5.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche (measured performance/capacity improvement) and explicitly excludes adjacent skills ("Do not use for generic code cleanup or an unmeasured incident postmortem"), which sharply reduces overlap with refactoring, debugging, and postmortem skills. This matches the clear-niche/minimal-conflict anchor at 5; the 4 anchor's 'minor overlap risk' is already addressed by the explicit exclusions.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 10 missing, 9 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 1 missing, 1 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

Noorkhalel/saas-ai-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.