AGENT SKILL

compose-catalogs-setup

Run right after the compose-catalogs plugin is installed, or when the hosted catalog server cannot be reached or asks for access. Checks the hosted preview.coo.ee catalog server, completes the access grant, and shows one catalog so the person sees it working.

License 许可
Apache-2.0
最近更新
2026-11-15
Stars
★ 0
Forks
0

01 前言 Front Matter

name
compose-catalogs-setup
description
Run right after the compose-catalogs plugin is installed, or when the hosted catalog server cannot be reached or asks for access. Checks the hosted preview.coo.ee catalog server, completes the access grant, and shows one catalog so the person sees it working.

03 SKILL.md 正文

Set up Compose Catalogs

This is the plugin's onboarding skill. It needs no local toolchain. Keep it to a few tool calls and report each step in one line. Open by pointing the person at https://ui.coo.ee/start.

  1. One hosted server. The only MCP URL is https://preview.coo.ee/mcp; https://ui.coo.ee/mcp is an alias of the same server. If the host also has a ui.coo.ee/mcp entry (every catalog tool listed twice), remove that entry from the host's MCP config, keep preview.coo.ee/mcp, and say so. Never add a ui.coo.ee/mcp entry.
  2. Reach the server. Call list_projects on the compose-preview-catalog server once; it lists the catalogs. If the server is unreachable, say so with the error text and stop; do not retry in a loop.
  3. Access. Distinguish the host connection from server access:
    • If the host reports an expired Compose Preview connection, show its reconnect action and stop tool retries. If the authorization page reports an unknown client_id, tell the person that reinstalling a marketplace plugin may retain the same rejected ID. The operator must restore its trusted registration, or the host must create a fresh app/registration. A changed app ID also needs updated plugin manifests; use the marketplace recovery steps in the host setup notes. Neither repeating that link nor request_access repairs a missing registration.
    • Only a reachable server's authorization_required response starts the grant flow below. A network/proxy error alone does not establish that a grant expired.
    • Do not clone catalogs, start Gradle or provision a cloud environment for this hosted flow. If the server asks for access:
    • Where the host supports URL elicitation, follow the access link it opens.
    • Otherwise use the text fallback: call request_access, show the person the link it returns, then call poll_access once they say they have approved it.
    • A COMPOSE_PREVIEW_TOKEN set in the plugin settings or the environment skips this step.
  4. First catalog. Name the catalogs in one line (for example Material 3 and Wear). Pick one small component with catalog_list_previews, render it with catalog_render_preview, and describe it in a line.
  5. Close with one line: ask for any component by name ("show the Wear Button variants"), or open the catalog from the sidebar where the host shows it.

04 同仓库更多 Skills

yschimke
yschimke/compose-agent-plugins

harness-notes

Use whenever you change Compose UI code (composables, @Preview functions, themes) or render or review Compose previews, catalog components or UI Builder designs. Carries the mandatory cross-harness agent rules (R1–R4) and per-host notes for these tools.

★ 0
yschimke
yschimke/compose-agent-plugins

compose-preview-setup

Run right after the compose-preview plugin is installed, or when a render fails because the CLI is missing or the project is "not prepared". Checks the compose-preview CLI, prepares the current Gradle project once, and renders one preview so the person sees it working.

★ 0
yschimke
yschimke/compose-agent-plugins

antigravity-viewer-card

Show a render of the person's own Compose previews in Antigravity — one render_preview call with preview=<FunctionName> on the local compose-preview-mcp server, a look at the PNG, then the card and a few bullets.

★ 0
yschimke
yschimke/compose-agent-plugins

spike-p2

Use when the user says 'spike check'.

★ 0
yschimke
yschimke/compose-agent-plugins

spike-p1

Use when the user says 'spike check'.

★ 0
yschimke
yschimke/compose-agent-plugins

compose-preview-review

Review Compose UI previews and pull requests by rendering base and head, diffing them, and checking catalog design guidelines. Use for a UI design review, a UI PR locally or from a CI agent session (@claude mention), authoring an agent-opened PR that touches UI, or triaging flaky or unstable previews (time/random/animation). Pairs with the compose-preview skill; for wiring the CI that posts those diffs, see the compose-preview-ci skill.

★ 0