adobe-design-from-template

Files (1)

• SKILL.md

SKILL.md (first lines)

# Adobe Design from Template

Helps users find an Adobe Express template and customize it — updating text,
background color, and animation — producing a finished Express document ready
to share or open in Express for further editing.

---

## Tool Reference

| Step | Tool | Notes |
|------|------|-------|
| Search for template | `search_design` | Interactive picker; user selects URN |
| Edit text and copy | `fill_text` | Retry once on transient error |
| Change background color | `change_background_color` | Pass hex; infer from color description if needed |
| Animate design | `animate_design` | Skip on 403 entitlement; no retry |

---

## Workflow

### Step 0 — Initialize Adobe Tools

Call `adobe_mandatory_init` first. This returns file handling rules and tool routing guidance required for the rest of the workflow.

```json
{ "skill_name": "adobe-design-from-template", "skill_version": "1.0.1" }
```

---

### Step 1 — Entitlement Check

Now that `adobe_mandatory_init` confirmed that the "Adobe for creativity" connector is live, check which tools are available through the "Adobe for creativity" connector by cross checking against the Tool Reference table above.

---

### Step 2 — Build the search query (don't ask questions first)

Extract the design type from whatever the user said and go straight to Step 3.
Asking clarifying questions before showing templates creates friction; the picker
lets users course-correct visually, which is faster.

| User says                        | Query to use               |
| -------------------------------- | -------------------------- |
| "make me a flyer"                | `"flyer"`                  |
| "I need something for Instagram" | `"Instagram post"`         |
| "design a poster for my event"   | `"event poster"`           |
| "make a business card"           | `"business card"`          |
| "flyer for an ice cream social"  | `"ice cream social flyer"` |

---

### Step 3 — Search for a template

Call `search_design`:

```json
{
  "generalQuery": "<design type from user prompt>",
  "pageSize": 24
}
```

This renders an interactive picker in the chat. The user taps a template to select
it; the URN comes back automatically. If the user says "show more", call
`search_design` again with the same query and increment `startIndex` by `pageSize`.

---

### Step 4 — Confirm selection and offer edits

Once a template is selected, confirm what was picked and ask what to customize:

> "Got it — you've selected [template name]. What would you like to change?
>
> - ✏️ **Edit the text** — names, dates, headlines, copy
> - 🎨 **Change the background color**
> - ✨ **Animate it**
> - ✅ **I'm done** — just give me the link"

The user may choose one, several, or none. Apply each in sequence, then loop back
and ask if they want anything else before wrapping up.

---

### Step 5 — Apply edits

After each edit, ask: *"What else would you like to change, or does this look good?"*

#### Edit text / copy

Call `fill_text`:

```json
{
  "templateURN": "<URN>",
  "description": "<what to change and what to change it to>",
  "generalQuery": "<same, minus any PII>"
}
```

If the user hasn't specified what the text should say, ask before calling.

`fill_text` occasionally fails on the first attempt due to transient errors — if
it returns an error, retry once with identical parameters before reporting failure.

#### Change background color

Call `change_background_color`:

```json
{
  "templateOrDocumentURN": "<URN>",
  "backgroundColor": "<hex>",
  "description": "<e.g. change background to coral pink>",
  "generalQuery": "<same, minus any PII>"
}
```

From kalash33/kstack, Apache-2.0.

More from kalash33/kstack