Overview
The visual quality diagnosis assistant is used to answer "Is this image good enough to publish?", AI generation, prompts, and visual creativity. It is suitable for marketing, operations, content media, and e-commerce to call after clarifying business goals, content materials, or analysis targets. It will combine image creative descriptions, pasted image themes, product descriptions, visual concepts, prompt drafts, size ratios, or publishing requirements. and other inputs, organize key context, and output summaries, diagnostic conclusions, action recommendations, and reusable deliverables for continued execution, review, or delivery.
When to Use
Applicable Scenarios
- When users ask questions such as "Is this image good enough to publish?" and need to quickly break down goals, determine priorities, and form actionable results
- When marketing, operations, content media, and e-commerce need to generate summaries, diagnostic conclusions, action recommendations, and reusable deliverables around the visual quality diagnosis assistant
- When users have already prepared the image goal (for example, increasing clicks, explaining a product, building brand texture, social media communication, advertising conversion, or campaign warming.)、audience (describing the users, customers, platform viewers, or internal reviewers the image is intended for.)、image reference links (providing reference images, landing pages, competitor visuals, or material description links that can be accessed without logging in.), and hope to organize them into actionable analysis or optimization results
- When users need to turn materials related to the visual quality diagnosis assistant into clear conclusions, priorities, and next-step actions
How to Call
Call the AI Skills API directly through the exported Python runner:
Command Example
Basic Call
python3 scripts/run.py --params '{}'
Call with Common Parameters
python3 scripts/run.py --params '{"goal":"图片目标"}'
Parameter Description
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
goal |
string | No | - | For example, increasing clicks, explaining a product, building brand texture, social media communication, advertising conversion, or campaign warming |
audience |
string | No | - | Describe the users, customers, platform viewers, or internal reviewers the image is intended for |
materialUrl |
string | No | - | Provide reference images, landing pages, competitor visuals, or material description links that can be accessed without logging in; a complete accessible URL must be passed |
materialFile |
string | No | - | Upload reference images, product images, brand visual materials, or style samples to help organize the image generation brief |
materialText |
string | No | - | Paste the image theme, product description, visual concept, prompt draft, size ratio, or publishing requirements |
brandRequirements |
string | No | - | Supplement brand colors, visual restrictions, elements that must appear/must not appear, copyright authorization, and compliance restrictions |
See the complete machine-readable parameter structure at references/form-schema.json。
Parameter Value Reference
This skill currently has no categorical parameters that require additional lookup tables.
Supported Input Formats
This skill directly accepts JSON parameters; if the parameters include link fields, please pass complete, accessible URLs.
Example Request
The following example parameters can be passed directly to scripts/run.py, and the runner will send them to the AI Skills API.
python3 scripts/run.py --params '{"goal":"图片目标"}'
Equivalent --params JSON:
{
"goal": "图片目标"
}
Example return result
{
"success": true,
"data": {
"message": "示例结果请以技能真实返回结构为准。"
},
"meta": {
"executionTime": 842,
"cached": false
}
}
Deliverables
- Summary, diagnostic conclusions, action recommendations, and reusable deliverables: organize the core results around the user's goals that can be directly read, reviewed, or delivered.
- Interpretation of input materials: combine the image goals (for example, increasing clicks, explaining the product, building brand quality, social media communication, advertising conversion, or campaign teaser.), the viewing audience (describe the users, customers, platform viewers, or internal reviewers the image is intended for.), and the image reference links (fill in reference images, landing pages, competitor visuals, or material description links that can be accessed without logging in.) to extract key context and the basis for judgment.
- Next steps: provide priorities, execution recommendations, or a content framework that can be further developed.
Suggestions for using the results
- First determine whether the output answers the user's core questions about the "Visual Quality Diagnostic Assistant".
- Then check whether the results cover the summary, diagnostic conclusions, action recommendations, and reusable deliverables, and whether clear next steps are provided.
- If there is little input material, it is recommended to have the user supplement the goals, audience, constraints, or original materials before running.
Preparation before running
AISKILLS_BASE_URL: defaulthttps://ai-skills.aiAISKILLS_API_KEY: required, used for authenticated callsAISKILLS_TENANT_ID: defaultdefault