kris/afv-library
1
0
Fork 0
mirror of https://github.com/forcedotcom/afv-library.git synced 2026-07-30 11:19:27 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Add media-management skill

Browse Source
This commit is contained in:
Udai Arora 2026-04-01 13:54:06 -07:00
parent 483127c4ef
commit 8df36d859e
No known key found for this signature in database
GPG Key ID: 42AC5677075EECDF
1 changed files with 77 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

77
skills/media-management/SKILL.md Normal file
View File

@ -0,0 +1,77 @@
---
name: media-management
description: Generates new images using AI image generation tools. If image generation is not available or fails, uses a placeholder.svg. Use when the user asks to generate, create, or add new images or media assets — not when searching for existing media.
---
# Media Management
## Workflow
1. Check if the `media-management` MCP server is configured and its `create_image` tool is available.
2. If available, use `create_image` to generate the image.
3. If not available, use the placeholder fallback below.
## MCP: media-management
**Tool:** `create_image`
Check your available tools. If `create_image` is present, use it as the primary image generation method — pass the natural language prompt and applicable parameters from the table below.
If `create_image` is not in your tool list, the `media-management` MCP is not configured — use the placeholder fallback below.
## Image Generation Parameters
Use these defaults unless the user specifies otherwise:
| Parameter | Default | Options |
|---|---|---|
| `model` | `Standard` | `Standard`, `Premium` |
| `size` | `auto` | `auto`, `1024x1024`, `1536x1024`, `1024x1536` (pick closest to user-requested size) |
| `quality` | `medium` | `low`, `medium`, `high` |
| `outputCompression` | `75` | `0–100` (webp/jpeg only) |
| `outputFormat` | `webp` | `webp`, `jpeg`, `png` |
| `background` | `auto` | `auto`, `transparent`, `opaque` |
**Format rule:** If `outputFormat` is `png`, set `outputCompression` to `100`.
## After Successful Generation
Automatically download and preview the image:
**1. Retrieve credentials:**
```bash
TARGET_ORG=$(sf config get target-org --json | jq -r '.result[0].value')
```
**2. Download the image:**
```bash
mkdir -p "generatedimages"
curl -f -H "Authorization: Bearer $ACCESS_TOKEN" "$URL" -o "generatedimages/<responseId>.<outputFormat>"
```
**3. Preview in VS Code:**
```bash
code generatedimages/<responseId>.<outputFormat>
```
**Never resize or post-process the generated image with external tools.** To control display dimensions, use CSS properties (e.g. `width`, `height`, `object-fit`) at the point of use.
## Fallback: Use placeholder.svg
If image generation fails or is not enabled:
1. Check if `generatedimages/placeholder.svg` already exists.
2. If it exists, use it as-is — do not download again.
3. If it does not exist, download it:
```bash
mkdir -p generatedimages
curl -f -o generatedimages/placeholder.svg "https://cdn.scs.static.lightning.force.com/resources/itsm-msteams-employee-app/ypmv18/1.0/assets/botWelcome-jMr02H0D.png"
```
## Placeholder Policy
There is only one placeholder: `generatedimages/placeholder.svg`.
- **Never** generate alternative placeholder images using Python, ImageMagick, or any other tool.
- **Never** resize or create new placeholder files of different dimensions.
- If the user requests a placeholder of a specific size or format, inform them that only `placeholder.svg` is available and that it can be scaled to any size using CSS properties (e.g. `width`, `height`, `object-fit`) at the point of use.