mirror of
https://github.com/forcedotcom/afv-library.git
synced 2026-07-30 11:43:26 +08:00
update skill
This commit is contained in:
Udai Arora
parent
6053de53a7
commit
d152f74a93
68
skills/image-generation/SKILL.md
Normal file
68
skills/image-generation/SKILL.md
Normal file
@ -0,0 +1,68 @@
|
||||
---
|
||||
name: image-generation
|
||||
description: Orchestrates how to handle image creation requests. Decides whether to delegate to the media-management MCP tool or fall back to a placeholder when the MCP is unavailable. Use when the user asks to add, include, or place an image or media asset in their project.
|
||||
---
|
||||
|
||||
# Media Management
|
||||
|
||||
This skill defines the decision flow for handling image creation requests. It does not generate images itself — it determines what to do based on what is available.
|
||||
|
||||
## Decision Flow
|
||||
|
||||
1. Look at your available tools. If `create_image` is present, proceed to **Using the MCP Tool**.
|
||||
2. If `create_image` is not available, proceed to **Fallback: Placeholder**.
|
||||
|
||||
## Using the MCP Tool
|
||||
|
||||
Delegate image generation to the `create_image` tool from the `media-management` MCP server. (`media-management` here refers to the MCP server name, not this skill.)
|
||||
|
||||
Apply these defaults unless the user specifies otherwise:
|
||||
|
||||
| Parameter | Default | Options |
|
||||
|---|---|---|
|
||||
| `model` | `Standard` | `Standard`, `Premium` |
|
||||
| `size` | `auto` | `auto`, `1024x1024`, `1536x1024`, `1024x1536` (pick closest to 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 the tool responds
|
||||
|
||||
Download and preview the result:
|
||||
|
||||
```bash
|
||||
# Retrieve credentials
|
||||
TARGET_ORG=$(sf config get target-org --json | jq -r '.result[0].value')
|
||||
|
||||
# Download
|
||||
mkdir -p "generatedimages"
|
||||
curl -f -H "Authorization: Bearer $ACCESS_TOKEN" "$URL" -o "generatedimages/<responseId>.<outputFormat>"
|
||||
|
||||
# Preview
|
||||
code generatedimages/<responseId>.<outputFormat>
|
||||
```
|
||||
|
||||
Use CSS (`width`, `height`, `object-fit`) to control display size. Never resize using external tools.
|
||||
|
||||
## Fallback: Placeholder
|
||||
|
||||
When `create_image` is not available, use a static placeholder instead of attempting image generation.
|
||||
|
||||
1. Check if `generatedimages/placeholder.svg` already exists.
|
||||
2. If it exists, use it — do not download again.
|
||||
3. If it does not exist, download it:
|
||||
|
||||
```bash
|
||||
mkdir -p generatedimages
|
||||
curl -f -o generatedimages/placeholder.svg "https://res.cloudinary.com/dveb6nwve/image/upload/v1775081606/placeholderFinal_l03h2n.svg"
|
||||
```
|
||||
|
||||
## Placeholder Policy
|
||||
|
||||
- Only one placeholder exists: `generatedimages/placeholder.svg`.
|
||||
- Do not generate alternative placeholders using Python, ImageMagick, or any other tool.
|
||||
- Do not create resized or reformatted versions of the placeholder.
|
||||
- If the user asks for a placeholder of a different size or format, inform them that only `placeholder.svg` is available and direct them to use CSS to scale it at the point of use.
|
||||
@ -1,77 +0,0 @@
|
||||
---
|
||||
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://res.cloudinary.com/dveb6nwve/image/upload/v1775081606/placeholderFinal_l03h2n.svg"
|
||||
```
|
||||
|
||||
## 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.
|
||||
Loading…
Reference in New Issue
Block a user