CtrlK
BlogDocsLog inGet started
Tessl Logo

perf-profile

Performance profiling — find bottlenecks, measure against budgets, produce ranked optimization recommendations.

57

Quality

72%

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 ./.claude/skills/perf-profile/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 well-sequenced, highly actionable phased workflow with genuine validation gates (input-existence checks, config fallbacks, permission asks) and a complete report template. Its weaknesses are repetition — the anti-fabrication warning appears three times — and narrative padding that could be tightened without losing the guardrails.

Suggestions

State the unset-budget/place-holder warning once (in the header's insufficient-input section) and reference it briefly from Phase 2 and Phase 4 instead of repeating it three times.

Trim the narrative asides (the observed false-clean-pass anecdote, the dead-settings-audit rationale) to one line each; the operative rule stands without the story.

Move the Phase 3 CPU/memory/rendering/I/O target checklists into a `references/profiling-targets.md` to keep SKILL.md as a lean overview.

DimensionReasoningScore

Conciseness

The phased workflow is mostly efficient and free of generic concept explanations, but the "do not report headroom against an unset budget" warning is repeated nearly verbatim in the header, Phase 2, and Phase 4, and the narrative asides (the observed false-clean-pass story, the dead-settings-audit rationale for not looping) pad beyond what instructs. This fits "mostly efficient but includes some unnecessary explanation or could be tightened" better than the minor-trimmings anchor of 4.

3 / 5

Actionability

Concrete, executable guidance dominates: exact bash commands with fully spelled dotted keys, a copy-paste markdown report template, a named destination path (`production/polish/[scope]-report-[date].md`), explicit decision options A–D, and a verdict format. Minor gaps keep it below 5: "estimate cost" for `_process()`/`Update()` targets gives no method, and no runtime profiler command is provided (though static analysis is the stated scope).

4 / 5

Workflow Clarity

Phases 0–6 are clearly sequenced with strong validation checkpoints: the FOUND/ABSENT input checklist with an explicit stop condition, unknown `performance.enforce` values surfaced with a `warn` fallback, a permission ask before writing the report, and conditional activation of Phase 5. It falls short of 5 due to minor gaps — no verification after the report is written, and the "Verdict" section is placed before Phase 6 (Next Steps), a small sequencing oddity.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the ~230-line body is well-sectioned per phase with each external doc reference (`.claude/docs/config-resolution.md`, `.claude/docs/automation-modes.md`, the yaml-helper hook) clearly signaled and one level deep. This matches good structure with minor organization gaps; the Phase 3 profiling-target checklists and the report template are candidates to split into reference files as the skill grows, which keeps it below 5.

4 / 5

Total

15

/

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.

The description is concise and specific about what the skill does, with three concrete actions and a clear niche. Its main weakness is the complete absence of any "when to use" trigger guidance, which caps completeness and leaves users without natural invocation cues beyond the skill's name.

Suggestions

Add a "Use when..." clause, e.g. "Use when the user mentions performance, profiling, frame rate, budgets, or asks why something is slow."

Include natural synonyms users actually say ("slow", "lag", "frame rate", "FPS", "optimize") alongside the current terms.

Optionally state the output (a written profiling report with ranked recommendations) to round out coverage of what the skill produces.

DimensionReasoningScore

Specificity

"find bottlenecks, measure against budgets, produce ranked optimization recommendations" lists three concrete actions in a named domain ("Performance profiling"), matching the anchor for several specific actions with minor gaps — it omits profiling scope (CPU/memory/rendering) and the written report output, so it is not comprehensive enough for a 5.

4 / 5

Completeness

The "what" is clear (find bottlenecks, measure against budgets, produce ranked recommendations) but there is no "Use when..." clause or any equivalent explicit trigger guidance — the judging guideline caps completeness at 3 in that case. It is not a 4 because the "when" is entirely absent rather than merely less explicit, and not a 2 because the "what" is concrete, not vague.

3 / 5

Trigger Term Quality

Terms like "Performance profiling", "bottlenecks", "budgets", and "optimization recommendations" are phrases a user would naturally say when needing this skill, but common variations such as "slow", "lag", "frame rate", "FPS", or "profiler" are missing, which fits the good-coverage-with-a-few-gaps anchor rather than comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

"Performance profiling — find bottlenecks, measure against budgets, produce ranked optimization recommendations" carves a distinct niche with specific triggers, though it could minorly overlap with a generic optimization or code-review skill in the same suite. It is not a 5 because "optimization" is a broad term shared with adjacent skills; not a 3 because the budget-measurement and ranked-recommendation framing is clearly differentiated.

4 / 5

Total

15

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
Donchitos/Claude-Code-Game-Studios
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.