aktual: Skill for Claude Code

Grab images of changed UI and put them in the PR description. Works with no display, so it suits cloud sessions. It renders composables in a desktop Compose test, not the running app.

1. Pick what to capture

• $ARGUMENTS says what to capture, if given. Otherwise take the composables changed on this branch (git diff origin/main --stat, then look in */ui/ and */components/ modules).
• Prefer the scaffold/content composable that takes plain state (e.g. InfoScaffold(state, onAction)), not the Screen that needs a VM. Build the state from the file's @Preview functions, which are private, so copy their arguments.
• Default to dark colors. Add LightColors (and MidnightColors) only when the change is about color, or when asked.
• Keep it small: one or two images per changed screen or state.

2. Write a throwaway test

Create <module>/src/desktopTest/kotlin/<package>/ScreenshotTest.kt in the module that owns the composable, in the same package so internal composables are visible. Every compose module already has aktual-test:compose on its test classpath.

package aktual.about.ui.info

import aktual.core.theme.LightColors
import aktual.test.screenshot
import androidx.compose.ui.test.onNodeWithText
import androidx.compose.ui.test.performClick
import kotlin.test.Test

class ScreenshotTest {
  // Full screen, phone size, dark colors
  @Test fun info() = screenshot("info") { InfoScaffold(buildState = STATE, onAction = {}) }

  // Cropped to the composable's own size, for components and dialogs
  @Test
  fun dialog() = screenshot("no-update-dialog", fitContent = true) {
    NoUpdateFoundDialogContent(onDismiss = {})
  }

  // Interact before capture
  @Test
  fun sortSheet() =
    screenshot("sort-sheet", colors = LightColors, interact = { onNodeWithText("Sort").performClick() }) {
      LicensesScaffold(...)
    }
}

screenshot() lives in aktual-test/compose/src/desktopMain/kotlin/aktual/test/Screenshots.kt. Parameters: colors, widthDp/heightDp (default phone, use MY_MONITOR_WIDTH_DP/MY_MONITOR_HEIGHT_DP for desktop layouts), density (default 2), fitContent, interact.