Skills

Skills for rendering and reviewing Jetpack Compose and Compose Multiplatform UI from agent workflows. They pair with the compose-preview CLI and Gradle plugin published from yschimke/compose-ai-tools — the CLI does the rendering, these skills tell the agent how to drive it.

Install

Three install paths — all of them end up with a working compose-preview CLI on $PATH. The two skill-marketplace paths ship a self-bootstrapping stub at skills/compose-preview/scripts/compose-preview; the first time that stub is invoked it runs the canonical installer (--cli-only) and re-execs into the real CLI.

Curl the installer directly (gets CLI + both skill bundles + per-host symlinks for Claude Code and Codex into ~/.agents/skills/ in one shot):

curl -fsSL https://raw.githubusercontent.com/yschimke/skills/main/scripts/install.sh \
  | bash

Install as a Claude Code plugin — drops the skill content (including the bootstrap stub) into ~/.claude/plugins/:

/plugin marketplace add yschimke/skills
/plugin install yschimke-skills@yschimke-skills

Or via the skills CLI:

npx skills add yschimke/skills

With the two marketplace paths, the CLI download happens on first invocation of the stub — there's no separate "now install the CLI" step.

Skills

• compose-preview — render @Preview composables to PNG outside Android Studio. Covers Android (Jetpack Compose via Robolectric) and Compose Multiplatform Desktop (ImageComposeScene + Skia), with design notes on capture modes, multi-preview annotations, paused-clock animations, accessibility checks, display filters, Wear UI, resource previews, a Playwright-style token-frugal agent loop (semantic-ref targeting on Desktop + Android, observe/diff_semantics, render_preview crop, record-to-test, typed render-failure kinds), and cloud sandbox setup.
• compose-preview-review — review pull requests that change Compose UI by rendering @Preview composables on base and head and diffing them. Pairs with compose-preview; covers agent-authored PRs, local review workflows, and wiring compose-preview/main baselines + PR-comment GitHub Actions.
• compose-preview-design-board — assemble rendered @Preview PNGs into a single self-contained HTML design board (categories, groups, captions, layout) for import into Claude Design and other design tools. Pairs with compose-preview; turns a set of renders into one coherent brief rather than loose screenshots.
• compose-design-catalog — generate an importable design-artifact sticker sheet for a whole Compose component system (Compose M3, Wear Compose M3, Glimmer, Glance/Wear widgets): each component in its primary modes, in two variants (ideal render + bordered layout), with extracted design tokens and accessibility greenlines, laid out for Figma / Stitch / Claude Design import. Code-led — the published Figma kits are seed only. Pairs with compose-preview and compose-preview-design-board.

The CLI, Gradle plugin, renderer, MCP server, and VS Code extension live in yschimke/compose-ai-tools; this repo is content-only.

Contributing

Skills live at skills/<skill-name>/SKILL.md, flat (no language or topic nesting). The name: in the SKILL.md frontmatter must match the directory name. See AGENTS.md for the full contributor contract.

License

Apache 2.0