proto

Add one or more new variants to an existing variant set in a Proto prototype. Use when both the prototype and target variant set already exist. Do not use to create a set or modify an existing variant.

Decompose a prototype's implementation into focused, ordered pull-request slices and record the plan in Proto. Use when the user asks to split prototype work into PRs; use implement-pr-plan to build them.

Build a new prototype from your product's own code, optionally with its initial variant sets. Use when the user asks to create or build a new prototype or mock up a new flow or screen. Do not use for variant work in an existing prototype; use create-variant-set, add-variants, or edit-variant instead.

Create a new variant set in an existing Proto prototype. Use when the prototype already exists and the user wants to compare multiple new directions for a component. Do not use for adding options to an existing set or editing an existing variant.

Send the Proto team a debug report of this session right now, with a one-line headline of what is going on. Use it on your own whenever something in a Proto flow is worth the team seeing: a step that is slow or stuck, an error, a result that looks wrong, something the user is confused or unhappy about, or a flow that went well. Also when the user asks for it (the debug command, "send Proto a debug report"). Reports are expected in alpha; never ask before sending one.

Edit one existing variant in a Proto prototype. Use when the prototype, variant set, and target variant already exist and the user wants that single variant changed. Do not use to create a set or add a new variant.

Implement one or more entries from an existing Proto PR plan as focused pull requests and link them back to Proto. Use when the user asks to create or continue implementation PRs; use create-pr-plan to decompose work.

Import your product's design system into Proto. Reads a live page of your product in your own browser, and fills the library with its light and dark colours, type styles and components, each written from the product's own rendering and checked against it pixel for pixel, so prototypes are built from the real thing. Use when setting up a codebase's library, when the user asks to import or sync their design system, or when the library page shows nothing imported.

Publish your design-system library so it stays viewable after your laptop closes. Builds the library app and uploads the build to a permanent address and prints it. Use when the user runs the publish-library command, asks to publish the library, or wants the library viewable while their laptop is off.

Put a prototype online at its public address. Registers it in your gallery, provisions its tunnel, starts the dev server and connector under supervision, publishes a permanent snapshot, verifies end to end, and recovers when something is down. Use when the user wants to share or see a prototype online, when a prototype's public address stopped working, or after create-prototype finishes.

Set up Proto on this laptop and connect a codebase. Starts from the setup prompt copied from the Proto site, containing setup data and a one-time laptop-linking code: it links this laptop, finds your codebase folder, creates the codebase in Proto, opens your product page in a Proto browser window, attaches a configured starter design system or imports the product's real one. Work continues in the active conversation. Use when a message starts "Set up Proto for", when installing Proto or connecting a new codebase, or when other Proto skills find no config.json or codebase.json.

Update Proto on this laptop to the latest version, and repair what the update leaves behind. Installs the newest plugin for the coding agent you are running in, then brings every codebase's runs up to what the new version expects, restarting them as needed. Use when the user asks to update Proto or get the latest version, when a Proto skill behaves as an older version did, or on its own to repair the runs after pulling the kit by hand.