Overview
The Visual Quality Diagnostic 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 inputs such as GPT image generation requirements, pasted image descriptions, prompt drafts, product descriptions, text content, aspect ratio requirements, or publishing scenarios, ... to organize key context and output summaries, diagnostic conclusions, action recommendations, and reusable deliverables, making it easy to continue execution, review, or delivery.
When to Use
Applicable Scenarios
- The user asks questions such as "Is this image good enough to publish?" and needs to quickly break down goals, determine priorities, and form actionable results
- Marketing, operations, content media, and e-commerce need to generate summaries, diagnostic conclusions, action recommendations, and reusable deliverables around the Visual Quality Diagnostic Assistant
- The user has already prepared the image goal (for example, generating a brand key visual, advertising image, product scene, social media graphic, concept image, or instructional illustration.), target audience (describing the viewers, customers, platform readers, advertising audience, or internal reviewers the image is intended for.), and image reference links (providing reference images, product pages, brand visuals, or material description links accessible without login.), and hopes to organize them into actionable analysis or optimization results
- The user needs to turn materials related to the Visual Quality Diagnostic Assistant into clear conclusions, priorities, and next-step actions
How to Call
Call the AI Skills API directly through the exported Python runner:
Command Examples
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, generating a brand key visual, advertising image, product scene, social media graphic, concept image, or instructional illustration |
audience |
string | No | - | Describes the viewers, customers, platform readers, advertising audience, or internal reviewers the image is intended for |
materialUrl |
string | No | - | Provide reference images, product pages, brand visuals, or material description links accessible without login; a complete accessible URL must be provided |
materialFile |
string | No | - | Upload reference images, product images, sketches, brand materials, or visual samples for GPT Image 2 reference generation or style rewriting |
materialText |
string | No | - | Paste image descriptions, prompt drafts, product descriptions, text content, aspect ratio requirements, or publishing scenarios for direct image generation |
brandRequirements |
string | No | - | Supplement with brand colors, font/text requirements, prohibited styles, copyright authorization, likeness authorization, and compliance restrictions |
For the complete machine-readable parameter structure, see references/form-schema.json。
Parameter Value Reference
This skill currently has no categorical parameters that require an additional lookup table.
Supported Input Formats
The current skill directly accepts JSON parameters; if the parameters include a link field, please pass a complete, accessible URL.
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: refine key context and the basis for judgment based on the image goal (for example, generating a brand key visual, advertising image, product scene, social media graphic, concept image, or instructional illustration.), the viewing audience (describe the audience, customers, platform readers, advertising viewers, or internal reviewers the image is intended for.), and image reference links (fill in reference images, product pages, brand visuals, or material description links that can be accessed without logging in.).
- Next steps: provide priorities, execution suggestions, or a content framework that can continue to be processed.
Suggestions for using the results
- First determine whether the output answers the user's core question 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