Overview
The Visual Quality Diagnostic Assistant is used to answer "Is this image good enough to publish?", UI design, UX review, and design systems. It is suitable for product, operations, technical, and software use after clarifying business goals, content materials, or analysis targets. It combines inputs such as App page and flow descriptions, pasted App page descriptions, mobile flows, feature background, interface copy, design goals, or... 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
- Product, operations, technical, and software need to generate summaries, diagnostic conclusions, action recommendations, and reusable deliverables around the Visual Quality Diagnostic Assistant
- The user has already prepared App experience goals (explaining the conversion, retention, task completion, first-screen comprehension, trust, or premium feel goals they hope to improve.), mobile user scenarios (explaining target users, usage scenarios, device environment, one-handed/two-handed operation mode, and proficiency.), App prototypes or reference links (providing publicly accessible App prototypes, mobile web pages, design previews, product pages, or competitor reference links.), 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 Invoke
Directly call the AI Skills API through the exported Python runner:
Command Example
Basic Invocation
python3 scripts/run.py --params '{}'
Invocation with Common Parameters
python3 scripts/run.py --params '{"goal":"App 体验目标"}'
Parameter Description
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
goal |
string | No | - | Explain the conversion, retention, task completion, first-screen comprehension, trust, or premium feel goals you hope to improve |
audience |
string | No | - | Explain the target users, usage scenarios, device environment, one-handed/two-handed operation mode, and proficiency |
materialUrl |
string | No | - | Provide publicly accessible App prototypes, mobile web pages, design previews, product pages, or competitor reference links; a full accessible URL is required |
reviewDepth |
string | No | 标准诊断 |
Choose quick mobile review, standard App design review, or deep sleek polish; optional values:快速体检、标准诊断、深度改稿 |
materialFile |
string | No | - | Supports iOS/Android screenshots, mobile flow screenshots, prototype export images, design documents, or PDFs |
materialText |
string | No | - | Paste App page descriptions, mobile flows, feature background, interface copy, design goals, or current issues |
targetPlatform |
string | No | - | Choose iOS, Android, mobile Web, mini program, cross-platform App, or other mobile carriers |
brandRequirements |
string | No | - | Supplement brand style, platform guidelines, component library constraints, color/typography requirements, and information that must be retained |
For the complete machine-readable parameter structure, see references/form-schema.json。
Parameter value reference
This skill currently has no categorical parameters that require additional lookup.
Supported input formats
This skill directly accepts JSON parameters; if the parameters contain a link field, please pass a complete, accessible URL.
Example request
The example parameters below 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":"App 体验目标"}'
Equivalent --params JSON:
{
"goal": "App 体验目标"
}
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 App experience goals (explain the desired goals for conversion, retention, task completion, first-screen understanding, trust, or premium feel.), mobile user scenarios (explain the target users, usage scenarios, device environment, one-handed/two-handed operation, and proficiency.), App prototype or reference links (fill in publicly accessible App prototype, mobile web page, design preview, product page, or competitor reference links.) to extract key context and the basis for judgment.
- Next steps: provide priorities, execution recommendations, or a content framework that can be further 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 result covers the summary, diagnostic conclusions, action recommendations, and reusable deliverables, and whether it provides clear next steps.
- 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