CtrlK
BlogDocsLog inGet started
Tessl Logo

performance-oracle

Analyzes code for performance bottlenecks, algorithmic complexity, database queries, memory usage, and scalability. Use after implementing features or when performance concerns arise.

56

Quality

65%

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 ./.agents/skills/performance-oracle/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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-structured analysis framework with a clear review sequence and output format, but it is a persona prompt rather than a skill body: it instructs without providing executable tooling or examples, repeats knowledge Claude already has, and keeps everything inline despite no reference files. Tightening the persona framing and adding concrete measurement commands would raise both conciseness and actionability.

Suggestions

Cut the persona/mission framing ("You are the Performance Oracle, an elite performance optimization expert...", "Your primary mission is...") and state the analysis scope directly — Claude needs the checklist, not the identity.

Add executable guidance for the steps that currently assume knowledge: e.g., the actual commands or queries to inspect execution plans (EXPLAIN ANALYZE, rails db:explain), and one worked example of the required output format including a code-level optimization recommendation, since the body itself demands "specific code examples" it never shows.

Move domain-specific detail (Rails/ActiveRecord notes, benchmark suggestions, frontend bundle-size standards) into a one-level-deep reference file such as references/domain-notes.md and keep SKILL.md as a concise framework plus pointers, instead of inlining everything.

DimensionReasoningScore

Conciseness

The body is mostly structured checklists rather than padded prose, but fluff like "You are the Performance Oracle, an elite performance optimization expert..." and "Your primary mission is to ensure code performs efficiently at scale" earns nothing, and much of the framework (N+1 queries, memoization, lazy loading, unbounded structures) restates what Claude already knows. Matches anchor 3 ("Mostly efficient but includes some unnecessary explanation or could be tightened"); not 2 because there is no library-tour-style filler or concept tutorials, and the lists are scannable.

3 / 5

Actionability

The framework names concrete patterns to look for ("Detect N+1 query patterns", "Verify proper index usage", "Flag any O(n²) or worse patterns") and defines a structured output format, but includes zero executable commands, code examples, or tooling for how to actually measure anything (e.g., how to get a query execution plan), and its own demand "Always provide specific code examples" goes unexemplified. Matches anchor 3 ("Some concrete guidance but incomplete"); not 4 because there is no copy-paste-ready material at all.

3 / 5

Workflow Clarity

"Code Review Approach" gives a clearly sequenced five-pass process (anti-patterns → complexity → database/I/O → caching → scale projection) and the output format is a well-ordered five-section structure. Matches anchor 4 ("Clear sequence with most checkpoints present; minor validation gaps"); not 5 because there are no validation/verification checkpoints (e.g., how to confirm a suspected N+1 or benchmark a fix) and no error-recovery guidance; not 3 because the sequence is explicit and complete rather than gapped.

4 / 5

Progressive Disclosure

Section headers organize the ~130-line body well, but no bundle files exist and every domain checklist (Rails/ActiveRecord notes, benchmark guidance, per-domain details) is inlined in SKILL.md when it could be split into one-level-deep reference files. Matches anchor 3 ("Some structure but could be better organized; content that should be separate is inline"); not 4 because there is no reference structure at all for a body of this length, and not 2 because the inline content is genuinely sectioned and navigable.

3 / 5

Total

13

/

20

Passed

Description

75%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 solid description with an explicit what and when, specific capability areas, and good natural keywords. It could reach 5 with concrete user-utterance triggers ("slow", "will it scale", "latency") and slightly more varied action verbs.

DimensionReasoningScore

Specificity

"Analyzes code for performance bottlenecks, algorithmic complexity, database queries, memory usage, and scalability" lists five concrete analysis targets, matching anchor 4 ("Lists several specific actions; minor gaps in coverage"), though the single verb "Analyzes" is generic and coverage of e.g. frontend/network analysis mentioned only in the body is absent. Not 5 because the action verbs are less varied and comprehensive than the anchor-5 example; not 3 because it clearly names multiple specific capabilities rather than just 1-2.

4 / 5

Completeness

Both parts are present: a clear what ("Analyzes code for performance bottlenecks, algorithmic complexity, database queries, memory usage, and scalability") and an explicit when ("Use after implementing features or when performance concerns arise"), matching anchor 4 exactly. Not 5 because the when-clause lacks concrete trigger phrases tied to user utterances (e.g., "when the user says an endpoint is slow or asks if code will scale"); not 3 because the when is explicit, not weakly implied.

4 / 5

Trigger Term Quality

Terms like "performance bottlenecks", "database queries", "memory usage", and "scalability" plus the trigger "Use after implementing features or when performance concerns arise" give good keyword coverage, matching anchor 4. Not 5 because common natural phrasings users would actually say — "it's slow", "latency", "optimize this", "speed up" — are missing.

4 / 5

Distinctiveness Conflict Risk

The performance/scalability niche is mostly distinct from other skills, matching anchor 4. Not 5 because "Use after implementing features" is broad enough to overlap with general code-review or testing skills; not 3 because the domain (performance, complexity, memory, scalability) is clearly delineated and unlikely to fire for unrelated skills.

4 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository
udecode/plate
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.