CtrlK
BlogDocsLog inGet started
Tessl Logo

swiftui-performance-audit

SwiftUI performance: render, scroll, CPU/memory, updates, layout, Instruments.

52

Quality

57%

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/swiftui-performance-audit/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.

A well-structured, actionable audit workflow with a clear decision tree, executable Swift examples, a verification step, and correctly-linked one-level references. Main weaknesses are a verbatim duplicated culprit list between sections 1 and 3, and a code-smells catalog that should be split into a reference file per the progressive-disclosure pattern.

Suggestions

Remove the verbatim duplicate 'Prioritize likely SwiftUI culprits' list in section 3 (or replace it with a cross-reference to section 1) to save tokens.

Move the Common Code Smells catalog into references/code-smells.md and link to it, keeping only a one-line summary in SKILL.md.

Clarify or delete the 'Add Apple documentation and WWDC resources under references/ as they are supplied by the user' line since those files already exist in the bundle.

DimensionReasoningScore

Conciseness

The body is generally lean with no over-explanation of concepts Claude already knows, but section 3's 'Prioritize likely SwiftUI culprits' list is a verbatim six-bullet repeat of section 1's 'Focus on' list — a full duplicated block that should be tightened. This fits anchor 3 ('mostly efficient but includes some unnecessary... could be tightened'); it is not a 4 because a wholesale duplicated list is more than a minor trim, and not a 2 because the rest is efficient and unpadded.

3 / 5

Actionability

Concrete, executable Swift snippets for each code smell (formatter allocation, unstable identity, main-thread image decoding) with corrected versions, plus specific commands like 'Use the SwiftUI template in Instruments (Release build)'. It is not a 5 because the Remediate section's fixes ('Narrow state scope', 'Use equatable()') are named without code examples or specific steps, and not a 3 because the smell section gives copy-paste-ready patterns.

4 / 5

Workflow Clarity

The decision tree up front ('If code review is inconclusive, go to Guide the User to Profile') plus the sequenced 1–5 sections ending in a Verify step ('re-run the same capture and compare with baseline metrics') give a clear sequence with an explicit verification checkpoint and a recovery branch. It is not a 5 because the verify step is conditional ('if provided') with no explicit loop back to Remediate when deltas are unsatisfactory, and not a 3 because validation checkpoints are present, not merely implied.

4 / 5

Progressive Disclosure

The References section signals one-level-deep, clearly-named links that all resolve to real files in references/ (verified: all four listed paths exist with substantive content), and the SKILL.md stays an overview plus a reasonable inline checklist. It is not a 5 because the large Common Code Smells section (seven subsections with code) is prime material for a references/ split, and the line 'Add Apple documentation and WWDC resources under references/ as they are supplied by the user' is confusing given the files already exist; not a 3 because the structure and navigation are good.

4 / 5

Total

15

/

20

Passed

Description

47%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 a terse, distinctive topic list that identifies the right domain keywords, but it reads like a tag cloud rather than a capability description: no actions, no 'what it does', and no 'when to use it' clause. Adding one action verb and a Use-when trigger sentence would move it into the strong range.

Suggestions

Rewrite as a third-person action statement, e.g. 'Audits and fixes SwiftUI performance issues: render, scroll, CPU/memory, updates, layout, Instruments.'

Add a 'Use when...' clause, e.g. 'Use when the user reports slow, laggy, or janky SwiftUI views, high CPU/memory, scroll stutter, or hangs.'

Include common user phrasings (slow, laggy, frame drops, hangs) to improve both trigger matching and completeness.

DimensionReasoningScore

Specificity

"SwiftUI performance: render, scroll, CPU/memory, updates, layout, Instruments." names the domain and enumerates sub-areas, but contains no action verbs at all (no 'audit', 'profile', 'fix') — it is a topic list, not a description of capabilities. This matches anchor 2 ('Names the domain but actions are minimal or generic'); it is not a 3 because there are no concrete actions stated, and not a 1 because the domain and specific focus areas are clearly identified.

2 / 5

Completeness

The 'what' is only weakly implied (a topic list with no verb), and the 'when' is entirely absent — there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 and the vague what pushes it below. It fits anchor 2 ('Has a vague what and no when'); it is not a 3 because even the what lacks a stated action, and not a 1 because the domain is clearly named.

2 / 5

Trigger Term Quality

Terms like "SwiftUI", "performance", "scroll", "CPU/memory", "layout", and "Instruments" are natural words a user would say when needing this skill (e.g. 'my SwiftUI list is slow scrolling', 'high CPU in my app'). It is not a 5 because common user phrasings like 'slow', 'laggy', 'jank', 'frame drops', and 'hangs' are absent, and not a 3 because the present keywords are specific and directly match real user vocabulary.

4 / 5

Distinctiveness Conflict Risk

"SwiftUI performance" carves out a clear niche and the enumerated areas (render, scroll, CPU/memory, Instruments) make it mostly distinguishable from generic Swift or UI-testing skills. It is not a 5 because the description lacks distinct trigger phrases that would unambiguously route 'my app is slow' type queries to it over a general profiling skill, and not a 3 because the overlap risk is minor.

4 / 5

Total

12

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
steipete/agent-scripts
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.