SwiftUI code review worksheet and agent skill

Review one change against its intended behavior

Use this worksheet when you have a change or feature to review and can state what the user should be able to do. It asks for the affected location, expected behavior, trigger, result, cause, evidence, correction, and next check.

Evidence can be executed, source-traced, or unresolved. A source-traced finding can be actionable when its callers and assumptions are clear; it should still say that the interaction was not run. Missing product requirements belong in open questions.

Use the worksheet or install the skill

1. Download and unpack the complete package. Read SKILL.md, both references, and LICENSE. You can use the worksheet manually without installing anything.
2. For an assistant supporting the Agent Skills format, place the complete compot-swiftui-review folder in a skills directory supported by that client. Follow its documentation to choose project or personal scope.
3. Confirm that the assistant lists compot-swiftui-review. Provide the change, the expected user behavior, and access to relevant callers.
4. Ask for findings with an evidence label and a targeted next check. Apply fixes when they are part of your task, then verify the affected interaction.

Worked example: Cancel changes the reminder schedule

The parent owns the reminder schedule. The feature contract says Save commits an edit and Cancel discards it. In the exercise, the sheet’s Stepper writes directly through a binding to the parent.

Start at 15 minutes, open the editor, increment once, and press Cancel. Source tracing predicts that the parent now holds 20 minutes: the edit happened before dismissal. The proposed correction is to edit a local draft and commit it only on Save, with a defined policy for swipe-to-dismiss.

Evidence: source-traced. These steps describe a review exercise, not a recorded simulator run. Verify Cancel, Save, and interactive dismissal in the actual app.

Counterexample: if the feature explicitly applies every adjustment immediately and closes with Done, the shared binding can be correct. Establish the save policy before reporting a defect.

import SwiftUI

struct ReminderReviewExercise: View {
    @State private var minutesBefore = 15
    @State private var isEditing = false

    var body: some View {
        VStack {
            Text("Reminder: \(minutesBefore) minutes before")
            Button("Edit schedule") { isEditing = true }
        }
        .sheet(isPresented: $isEditing) {
            ScheduleEditor(minutesBefore: $minutesBefore)
        }
    }
}

struct ScheduleEditor: View {
    @Binding var minutesBefore: Int
    @Environment(\.dismiss) private var dismiss

    var body: some View {
        Form {
            Stepper("\(minutesBefore) minutes before", value: $minutesBefore, in: 5...60, step: 5)
            Button("Cancel") { dismiss() }
            Button("Save") { dismiss() }
        }
    }
}

Read the complete exercise and review finding

How this fits with other Swift skills

This public edition is a compact workflow resource. AvdLee’s skill and SwiftUI Pro already include review guidance; use their broader framework references when needed. The Swift Agent Skills repository is a directory of independently maintained projects. This download includes none of their skill files or reference collections. No affiliation or endorsement is implied.

• AvdLee’s SwiftUI Agent Skill
• Paul Hudson’s SwiftUI Pro
• Swift Agent Skills directory

References and reuse

The public template, worksheet, and reminder exercise were written for Compot. Keep the included MIT notice when redistributing copies or substantial portions. The license covers these downloads, not external resources or other Compot products. Follow your coding assistant’s documentation for file discovery and skill activation.

• Apple: Managing user interface state
• Agent Skills format specification