name: prototype-pull description: >- Download another user's published prototype source from S3 and re-home it under the current user's SSO identity using acc prototype pull. Use when the user wants to pull, download, clone, fork, or copy someone else's prototype from a CloudFront URL or prototype ID. metadata: version: "1.1"

Prototype: pull published source (acc prototype pull)

Audience

Instructions for the Cursor agent helping non-technical PMs and Designers. Use plain language. Do not mention the old ac LDE CLI.

Prerequisites

• acc on PATH (see update-acc skill if missing).
• The source prototype must have been published at least once (so prototype.zip exists in the shared bucket).

Auth pre-flight

Before running acc prototype pull, verify AWS SSO auth for the dev-prototyper profile:

aws sts get-caller-identity --profile dev-prototyper 2>&1

• Returns account/ARN JSON — auth is valid, proceed to Steps.

• Fails (expired token, SSOTokenProvider, or similar error) — SSO session is expired or missing. This command requires interactive browser login so the agent cannot run it. Ask the user:

  Your AWS session for prototypes has expired. Please open a terminal — press Cmd+J (macOS) or Ctrl+J (Windows/Linux), or go to Terminal > New Terminal in the menu bar — and run this command:

  aws sso login --profile dev-prototyper
  

  A browser window will open for sign-in. Let me know when it's done.

  Wait for the user to confirm, then re-run the aws sts check. Only proceed to Steps once auth succeeds.

What "re-homing" means

The published prototype ID in the URL belongs to the original author (e.g. janedoe-login-redesign). After pull, a new folder is created using your SSO username and the project name from prototype.json inside the zip (e.g. johnsmith-login-redesign). The CLI warns if you pull your own prototype (publishing again would overwrite the live version).

Steps

1. Get from the user either:

   • A full preview URL (e.g. https://...cloudfront.net/someuser-login-redesign/), or
   • A bare prototype ID (e.g. someuser-login-redesign).

   Query strings and fragments on URLs are ignored by the CLI when extracting the ID.

2. Run from the directory where the new project folder should be created (or use -o):

   acc prototype pull "https://example.cloudfront.net/someuser-login-redesign/"
   

   Or:

   acc prototype pull someuser-login-redesign
   

   To place the new project under a subdirectory:

   acc prototype pull someuser-login-redesign -o ./prototypes
   

3. On success, open the printed folder in Cursor (File > Open Folder, or cursor <path> if available), then suggest acc prototype run --install so dependencies install cleanly.

Security

• Treat downloaded code like any external source: review before running scripts. Do not commit secrets.
• Follow project security rules for any edits (MSW mocks, no real credentials).

Manual recovery (only if SSO fails)

Do not attempt to run the SSO login yourself — it requires interactive browser auth. Ask the user to open a terminal (Cmd+J / Ctrl+J, or Terminal > New Terminal):

It looks like your AWS session has expired. Please open a terminal (Cmd+J on macOS, Ctrl+J on Windows/Linux, or Terminal > New Terminal in the menu bar), run this command, and let me know when it's done:

aws sso login --profile dev-prototyper

Wait for the user to confirm, then retry acc prototype pull.

Common errors

What not to duplicate

Vue/TS conventions remain in .cursor/rules/. This skill only covers downloading and re-homing via acc prototype pull.