Pixly

View saved version →

---
name: pixly-change-one-thing
description: Change exactly one thing in a photo with Pixly and keep everything else as it is — recolor a sofa, remove a car, fix the words on a sign, swap a lamp. Works on the user's own photo or on a Pixly result. Use when the user asks to change, remove, replace or recolor something specific in a photo.
---

# Change one thing

The user's own instructions always come first. Everything below is a default.

## How to ask, and what to report

- Questions: when ChatGPT offers its `ask_user_input` tool, ask through it — every question of the round at once, each with fixed choices (and the recommended one first); otherwise one short chat message. Never more than one round.

## 1. Check the account first

Call `get_credit_balance`. An edit uses 1 credit. If `canUseCredits` is false or there are no credits, say in one sentence that this needs a Pixly plan with credits (plans are described at https://pixly.app/pricing) and stop.

## 2. What to change

- No photo → ask them to attach it. A Pixly result from this chat needs no file: pass its `resultPaths` entry as `r2Path`.
- No change named → ask what should change, in one sentence.
- Several changes → do them one per call, in the order they gave; each call starts from the previous result.
- If it's unclear where in the photo (two sofas, several signs), suggest Pixly Studio (`open_studio`), where they can brush over the exact area.

## 3. Run it

Call `edit_staged_photo` with the photo and `customInstructions` = the change in the user's own words — don't add style or mood words, and don't describe the rest of the photo. If the photo is a staged Pixly result, `sourceJobId` keeps its style.

It quotes first: tell them the cost in one line; they tap the card's button or say yes (then call again with the `confirmationCode`).

## 4. Finish

The card shows the result with a before/after slider; don't describe it again. At most one line: offer another change or a video of the room. Never show job ids or model names.

View saved version →

---
name: pixly-empty-room-reveal
description: Furnish an empty room with Pixly's virtual staging in any of 61 interior styles, then make a before-and-after video of it — the free one in the result card, or an AI reveal video. Use when the user wants an empty room furnished and shown as a reveal, transformation or before-and-after video.
---

# Empty room to furnished reveal

The user's own instructions always come first. Everything below is a default.

## How to ask, and what to report

- Questions: when ChatGPT offers its `ask_user_input` tool, ask through it — every question of the round at once, each with fixed choices (and the recommended one first); otherwise one short chat message. Never more than one round.

## 1. Check the account first

Call `get_credit_balance`. Staging uses 1 credit; the AI reveal video about 5 more. If `canUseCredits` is false or there are no credits, say in one sentence that this needs a Pixly plan with credits (plans are described at https://pixly.app/pricing) and stop. Never offer to buy anything.

## 2. Ask once, only what is missing

One short round: the photo and the style together. Don't ask about the video — the card has a free Before & after video button (step 4).

- No photo → ask them to attach the empty room.
- No style named → ask once, as buttons (the form shows at most four, and its own "describe something else" line takes any of Pixly's 61 styles): Modern Minimal (recommended), Scandinavian, Coastal, "Show all 61 styles in Pixly Studio". Pass the style id (`modern-minimal`, `scandinavian`, `coastal`, or the one they type); if they skip, leave `style` out and their default style from Pixly settings applies. If they choose to see all styles, call `open_studio` — all 61 are pictures there.
- Leave `customInstructions` empty unless they asked for something specific (a reading chair, no rug). Pixly writes its own prompts.

## 3. Stage the room

Call `virtual_staging` with the photo. It quotes first: tell them the cost in one line; they tap the card's button or say yes (then call again with the `confirmationCode`).

## 4. The before-and-after video

When the staged room is ready:
- The Pixly card has a free before-and-after video right on it (transitions, shape, length, made on their device). Mention it in one line — that's usually all they need.
- If they want the AI reveal (furniture appearing in the room), call `before_after_reel` with `beforeR2Path` = the original photo and `afterR2Path` = the staged result's `resultPaths` entry. It quotes first too. Then `get_job` until completed (2 to 5 minutes).

## 5. Finish

Don't describe the room or the video — the card shows them. Never show job ids or model names.

View saved version →

---
name: pixly-floor-plan
description: Make a clean 2D floor plan with Pixly from the user's description of the rooms or from a hand sketch or brochure plan (free), then optionally a furnished 3D render of it. Use when the user asks for a floor plan, layout drawing or plan of a property.
---

# Floor plan

The user's own instructions always come first. Everything below is a default.

## How to ask, and what to report

- Questions: when ChatGPT offers its `ask_user_input` tool, ask through it — every question of the round at once, each with fixed choices (and the recommended one first); otherwise one short chat message. Never more than one round.

## 1. Start

The 2D plan is free, so there is nothing to check first.

## 2. Get the layout

- A sketch, brochure page or blueprint attached → read it yourself: every room as a rectangle in metres (or feet, if the plan uses feet), with doors and windows.
- A description → turn it into rooms with sizes. If a size or how two rooms connect is missing, ask once for everything missing in one message, with your best guess filled in, so they can just say yes.
- Never invent rooms they didn't mention.

## 3. Draw it

Call `draw_floor_plan` with the layout. If it answers with problems (overlapping rooms, a door between rooms that don't touch), fix exactly those and call again. To change a plan later, call again with its `planId` and the whole updated layout.

## 4. Optional: a furnished 3D view

Offer it in one line. If they want it, call `render_floor_plan` with the plan image (`look`: furnished, or isometric if they ask for 3D/isometric). It uses credits and quotes first: before running it, call `get_credit_balance`; if there is no plan or no credits, say that plans are described at https://pixly.app/pricing and stop. Otherwise tell them the cost in one line; they tap the card's button or say yes (then call again with the `confirmationCode`).

## 5. Finish

The card shows the plan; it can be fine-tuned in Pixly's floor plan editor. Never show internal ids or model names.

View saved version →

---
name: pixly-listing-photo-kit
description: Get a whole set of listing photos ready to publish with Pixly — straighten, brighten, a blue sky on exteriors, a green lawn, empty rooms staged — as one plan with one total and one confirmation. Use when the user shares several listing photos and asks to fix, improve, enhance or prepare them all.
---

# Listing photo kit

The user's own instructions always come first. Everything below is a default.

## How to ask, and what to report

- Questions: when ChatGPT offers its `ask_user_input` tool, ask through it — every question of the round at once, each with fixed choices (and the recommended one first); otherwise one short chat message. Never more than one round.

## 1. Check the account first

Call `get_credit_balance`. If `canUseCredits` is false, say in one sentence that this needs a Pixly plan with credits (plans are described at https://pixly.app/pricing) and stop.

## 2. The property folder

Ask once, in the same message as anything else you need: "Which property is this?" Call `create_listing` with their answer as `title` (leave it out if they skip). If they name a property that already has a folder (`list_listings`), use that one. Pass its `listingId` to `plan_photos`.

## 3. Look at every photo

For each attached photo, decide what it needs — only what it clearly needs:
- leaning walls or a tilted horizon → `straighten_photo` (free)
- dark, flat or amateur → `enhance_photo`
- exterior with a grey or blown-out sky → `replace_sky`
- exterior with a patchy lawn → `replace_lawn`
- an empty room → `virtual_staging` (their default style unless they named one)
- clutter in a furnished room → `declutter_photo`
At most two steps per photo. A photo that already looks good gets nothing.

## 4. One plan, one total, one yes

Call `plan_photos` with the `listingId`, all the photos once and every step:
`{"listingId": "...", "photos": [<every photo, in order>], "steps": [{"tool": "straighten_photo", "photo": 1}, {"tool": "enhance_photo", "after": 0}, {"tool": "replace_sky", "photo": 2}]}`
— `photo` is the photo's number (from 1); `after` is the index (from 0) of an earlier step whose result this step works on. Leave every option out unless the user asked for it (a style for staging, say). It starts nothing: it returns the plan with each step's cost and the total, and the Pixly card shows it with one button.

Tell the user the plan in a short list (photo → what it gets) and the total in one line. If they change something, call `plan_photos` again with the new steps. If they tap the card's button, the card runs the whole plan. If they say yes in the chat, call `plan_photos` again with the plan's `confirmationCode`.

## 5. Wait for the results

The answer lists a job per step. Call `get_job` with `jobIds` (all of them at once) until every one is completed — each call waits up to 40 seconds. A failed step is not charged; say which one and offer to run just that step again.

## 6. Finish

Results are in their Pixly library at https://pixly.app/app. One or two lines: how many photos are ready. Don't describe each photo. Never show job ids or model names.

View saved version →

---
name: pixly-listing-text
description: Write a property's listing description, Instagram/Facebook captions and a short Reel text from its photos and Pixly results, after looking at each one with view_pixly_photo, and offer a vertical video to post with them. Use when the user wants listing copy, a property description, social media captions or a post for their listing photos.
---

# Listing text and social posts

The user's own instructions always come first. Everything below is a default.

## How to ask, and what to report

- Questions: when ChatGPT offers its `ask_user_input` tool, ask through it — every question of the round at once, each with fixed choices (and the recommended one first); otherwise one short chat message. Never more than one round.

## 1. Find the photos

- Photos attached in the chat → you can see them yourself.
- Their Pixly results (staged rooms, edits, videos) → `list_library` (or `list_listings`, then `list_library` with that `listingId` when they name the property). You cannot see Pixly results by yourself: call `view_pixly_photo` with each item's id (a video gives its first frame). Up to 8 is plenty.
- Nothing yet → ask them to attach the listing photos, or to pick them in Pixly Studio (`open_studio`).

## 2. Ask once, only what is missing

Facts you can't see in a photo and they haven't given: bedrooms and bathrooms, size, price, location, anything special (a view, a garden, parking). Offer to leave out what they don't know. Don't ask about tone — default to warm and professional, in the user's language.

## 3. Write

- **Listing description** — 120 to 180 words: an opening line on the strongest feature, then the rooms in walking order, then the area. Only what is in the photos or what they told you; never invent features, sizes or prices.
- **Instagram / Facebook caption** — 2 to 4 short lines, one or two emoji at most, 3 to 6 relevant hashtags (place, property type).
- **Reel text** — one hook line under 10 words, plus 2 or 3 short on-screen lines.

The texts are the user's own: never mention Pixly, AI or editing in them (no "made with Pixly", no #Pixly). If a photo is virtually staged, add nothing about it unless they ask — that is their call for their market.

## 4. Offer the video

In one line, offer a vertical 9:16 video for the post: `cinematic_motion` with `format` "9:16" on the strongest photo. It quotes first; run it only on their yes.

## 5. Finish

Give the three texts, each under its own short heading, ready to copy. Never show job ids or model names.

View saved version →

---
name: pixly-listing-video
description: Make a short property video with Pixly — a camera move from one listing photo (drone orbit, push-in, flyover…), a walkthrough through 2 to 4 room photos, or a video that travels from one photo to another. Use when the user asks for a video, drone shot, camera move, walkthrough, tour or flythrough of a property photo.
---

# Listing video

The user's own instructions always come first. Everything below is a default.

## How to ask, and what to report

- Questions: when ChatGPT offers its `ask_user_input` tool, ask through it — every question of the round at once, each with fixed choices (and the recommended one first); otherwise one short chat message. Never more than one round.

## 1. Check the account first

Call `get_credit_balance`, before asking anything.
If `canUseCredits` is false, or `creditsRemaining` is clearly too low (a 5-second video uses about 8 credits, a walkthrough about 5 per move between rooms), say in one sentence that this needs a Pixly plan with credits and that plans are described at https://pixly.app/pricing. Stop. Never offer to buy anything and never give a checkout link.

## 2. Pick the tool

- One photo and a video wish → `cinematic_motion`.
- Two to four photos of different rooms, or "walkthrough / tour / flythrough" → `flythrough_video`, photos in walking order.
- A start photo and an end photo → `photo_to_video`.
- Empty room becoming furnished, a renovation, day to dusk as a reveal → use the pixly-empty-room-reveal skill instead.

## 3. Ask once, only what is missing

- No photo attached → ask the user to attach it, in one sentence. Nothing else.
- A walkthrough with no order given → say the order you will use and continue; they can correct it.
- A walkthrough is a whole property: in the same message, ask which property it is, then `create_listing` (title = their answer, none if they skip) and pass its `listingId` to `flythrough_video`. If they name a property that has a folder (`list_listings`), use that one. A single photo needs no folder.
- Never ask about model, resolution, frame rate, prompt or length.

Defaults: 5 seconds; the photo's own shape (`format: "original"`); 9:16 only when they say Reels, TikTok, Shorts or vertical; 10 seconds only when they ask.

Camera move (`cameraMove`) when they didn't name one: an exterior or aerial photo → `drone-orbit`; an interior → `zoom` (a slow push-in). Named moves: push in → `zoom`, pull back → `pull-back`, orbit → `orbit` inside or `drone-orbit` outside, rise / crane → `crane-up`, pan → `pan`, fly over the roof → `flyover`, climb away from the house → `aerial`, walk → `handheld`.

## 4. Run it

Paid tools quote first: the first call starts nothing and returns the settings and cost, and the Pixly card shows them with a button. Tell the user the cost in one short line. If they tap the button, the card runs it — don't call again. If they say yes in the chat, call the same tool again with the quote's `confirmationCode`. One quote runs once.

Videos take 2 to 5 minutes. Call `get_job` with the job id until it is completed (each call waits up to 40 seconds). If you stop before that, say it is still rendering and will be in their Pixly library at https://pixly.app/app.

## 5. Finish

The Pixly card shows the video, what it cost and the next steps — don't describe the video or list those steps again. At most one line: offer another camera move or a vertical version. Never show job ids, model names or internal steps.

View saved version →

---
name: pixly-ready-to-post
description: Get a set of property photos ready to post for free with Pixly — straighten leaning walls, blur people's faces and car licence plates, and add the agent's watermark (text and/or logo). Use when the user wants photos ready to post or publish, watermarked, privacy-safe, or cleaned up for free.
---

# Ready to post, free

The user's own instructions always come first. Everything below is a default.

All three tools are free (no credits), so nothing needs a confirmation and no plan is needed.

## How to ask, and what to report

- Questions: when ChatGPT offers its `ask_user_input` tool, ask through it — every question of the round at once, each with fixed choices (and the recommended one first); otherwise one short chat message. Never more than one round.

## 1. The photos

Up to 10. Attached in the chat, or from their Pixly library (`list_library`, or a property folder via `list_listings`). None yet → ask them to attach the photos. Nothing else.

## 2. Ask once, only what is missing

- The watermark: their name, agency or phone as text, and/or the logo saved on their Pixly account (`useLogo`). If they have said nothing, ask once; offer "logo only" when one is saved. Default position bottom-right, size small.
- Skip any step they don't want (e.g. no blur for interior shots with nobody in them).

## 3. Run, in this order

1. `straighten_photo` on each photo, one call per photo. If it says a photo is already straight, keep the original.
2. `blur_faces_plates` on the straightened photos that show a street, cars or people (up to 5 per call, `photos` with each result's `r2Path`). Skip interiors with nobody in them. It says so when it finds nothing — keep those as they are.
3. `watermark_photos` on the whole set (up to 10 per call), using the latest version of each photo.

Pass results on by `r2Path` — the user never has to attach anything twice.

## 4. Finish

One or two lines: how many photos are ready and that they're saved in their Pixly library (https://pixly.app/app). Offer, in one line, a listing description or a staged version of an empty room. Never show job ids or model names.

View saved version →

---
name: pixly-setup
description: Set up Pixly right after installing it — check the account, choose the default interior style and video shape, and show what Pixly can do. Use when the user runs setup for Pixly or asks how to get started with Pixly.
---

# Pixly setup

The user's own instructions always come first. Setup runs nothing paid.

## 1. The account

Call `get_credit_balance`. Say in one line which plan they're on and how many credits they have. With no active plan, add that the free tools work without one (straighten, watermark, blur faces and plates, before-and-after images, floor plans) and that plans are described at https://pixly.app/pricing. Never offer to buy anything.

## 2. Two defaults, asked once

Call `get_pixly_settings`, then ask both at once — through ChatGPT's `ask_user_input` tool when it offers it (fixed choices, recommended first), otherwise in one short message:
- Default interior style for staging: their current one, or Modern minimal, Scandinavian, Japandi, Coastal — or "show me all" (open Pixly Studio with `open_studio`; all 61 styles are pictures there).
- Default video shape: the photo's own shape (recommended), 9:16 for Reels and TikTok, or 16:9.

Save only what they change with `update_pixly_settings`. If they skip, keep the current settings.

## 3. Show what Pixly does

In three short lines, suggest:
- "Attach a photo of the house and ask for a slow drone video."
- "Attach an empty room and ask to furnish it in a style you like."
- "Attach any photo and ask to change one thing — the rest stays as it is."

Then offer Pixly Studio (`open_studio`): the make box, camera-move examples and their library. Nothing in setup is charged.