---
name: pouyam-studio
description: Edit photos, videos, PDFs, Word documents and spreadsheets with POUYAM Studio. Use when the user asks to edit, retouch, color grade, crop, trim, caption, rotate or annotate a file "in POUYAM" or "with POUYAM Studio", or asks for a POUYAM edit link or recipe.
---

# POUYAM Studio

POUYAM Studio (https://www.pouyam.com/studio) edits files in the user's own
browser. You do not touch the file. You write a **recipe** (JSON list of edit
steps) and give the user a **Studio link**; they open it, review the steps,
choose the file, and export.

## Workflow

1. Work out the target: `photo`, `video`, `pdf`, `document` (DOCX/TXT/MD/HTML) or `sheet` (XLSX/CSV).
2. If the POUYAM MCP tools are available, call `get_studio_capabilities` once for
   the live preset lists and ranges. Otherwise use the reference below.
3. Write the recipe. Keep values tasteful (portrait retouch 10–40, looks 60–90%).
4. Get a link:
   - MCP: `create_studio_link` with `{ "recipe": … }`.
   - HTTP: `POST https://www.pouyam.com/api/studio/recipe-link` with `{ "recipe": … }`.
   - No tools: print the recipe in one ```json block and tell the user to open
     https://www.pouyam.com/studio, click "Have an edit recipe… Paste it here", paste,
     review and choose the file.
5. Reply in the user's language: one-line summary of the steps, then the link.
   Say the edit is ready to apply, not that it is done. Surface any `warnings`.

Never hand-encode `#recipe=` links.

## Recipe

```json
{ "format": "pouyam.studio.recipe/1", "title": "…", "target": "photo", "steps": [ … ] }
```

1–40 steps, applied in order. Plain text only. Pages are 1-based, times in seconds.

### photo
- `{"op":"look","preset":"cinematic","strength":85}` — natural, cinematic, editorial, portrait, fashion, film, mono, travel, urban, night, warm, cool, vintage, moody
- `{"op":"adjust","values":{"exposure":0.2,"contrast":10}}` — exposure −2..2; contrast, highlights, shadows, whites, blacks, temperature, tint, vibrance, saturation, texture, clarity, dehaze, vignette −100..100; sharpen, denoise, grain, skinSmooth, redness, shine, eyeBright, teethWhite 0..100
- `{"op":"retouch","recipe":"natural-skin"}` — natural-skin, studio-clean, soft-glow, beauty-detail, low-light
- `{"op":"lut","id":"teal-orange","strength":70}` — neutral, teal-orange, kodak-warm, bleach, moon, mono-lut
- `{"op":"auto","mode":"enhance"}` — color | enhance
- `{"op":"crop","aspect":"4:5"}` — 1:1, 4:5, 9:16, 16:9, 3:2, 2:3, 4:3, 21:9
- `{"op":"rotate","degrees":90}`, `{"op":"flip","axis":"horizontal"}`, `{"op":"straighten","degrees":-2}`
- `{"op":"text","text":"…","position":"bottom","size":64,"color":"#ffffff","weight":700,"background":false}`

### video (grade/text steps above apply to the first clip)
- `{"op":"trim","start":3,"end":12}`, `{"op":"speed","rate":1.25}`, `{"op":"fade","in":0.5,"out":0.8}`
- `{"op":"volume","level":0}`, `{"op":"caption","start":0,"end":2.5,"text":"…"}`, `{"op":"rotate","degrees":90}`

### pdf
- `{"op":"pdf.rotate","pages":[2],"degrees":180}` (or `"pages":"all"`)
- `{"op":"pdf.delete","pages":[6]}`, `{"op":"pdf.reorder","order":[2,1,3]}`
- `{"op":"pdf.note","page":1,"text":"Approved","x":0.7,"y":0.08,"size":22,"color":"#c62828"}`

### document
- `{"op":"doc.replace","find":"2025","replace":"2026","all":true}`
- `{"op":"doc.append","text":"…","style":"paragraph"}`, `{"op":"doc.prepend","text":"…","style":"heading"}`

### sheet
- `{"op":"sheet.set","sheet":1,"cell":"B2","value":"128400"}` — values only, no formulas

## Not possible through recipes
Object or background removal, generating images, video aspect crop, formulas,
merging several files. Say so and suggest the closest recipe or the Studio panel
to use by hand.

Full guide: https://www.pouyam.com/studio-ai/guide.md