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.
- One hosted server. The only MCP URL is
https://preview.coo.ee/mcp;https://ui.coo.ee/mcpis an alias of the same server. If the host also has aui.coo.ee/mcpentry (every catalog tool listed twice), remove that entry from the host's MCP config, keeppreview.coo.ee/mcp, and say so. Never add aui.coo.ee/mcpentry. - Reach the server. Call
list_projectson thecompose-preview-catalogserver once; it lists the catalogs. If the server is unreachable, say so with the error text and stop; do not retry in a loop. - 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 norrequest_accessrepairs a missing registration. - Only a reachable server's
authorization_requiredresponse 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 callpoll_accessonce they say they have approved it. - A
COMPOSE_PREVIEW_TOKENset in the plugin settings or the environment skips this step.
- If the host reports an expired Compose Preview connection, show its reconnect action
and stop tool retries. If the authorization page reports an unknown
- First catalog. Name the catalogs in one line (for example Material 3 and Wear). Pick one
small component with
catalog_list_previews, render it withcatalog_render_preview, and describe it in a line. - Close with one line: ask for any component by name ("show the Wear
Buttonvariants"), or open the catalog from the sidebar where the host shows it.
04 同仓库更多 Skills
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.
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.
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.
spike-p2
Use when the user says 'spike check'.
spike-p1
Use when the user says 'spike check'.
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.