web-design-guidelines

web-design-guidelines Visual Quality Diagnostic Assistant

Overview

The visual quality diagnostic assistant is used to answer "Is this image ready to publish?", UI design, UX review, and design systems, and is suitable for product, operations, technical, and software teams to invoke after clarifying business goals, content materials, or analysis targets. It combines inputs such as web content and specification descriptions, pasted web copy, page structure, design specification excerpts, component descriptions, or the issues currently intended to be checked, organizes key context, and outputs summaries, diagnostic conclusions, action recommendations, and reusable deliverables for continued execution, review, or delivery.

When to Use

Applicable Scenarios

When users ask questions like "Is this image ready to publish?" and need to quickly break down goals, determine priorities, and produce actionable results
When product, operations, technical, and software teams need to generate summaries, diagnostic conclusions, action recommendations, and reusable deliverables around the visual quality diagnostic assistant
When users have already prepared page goals (explaining the information delivery, conversion, registration, consultation, purchase, or task operation the page is expected to complete), visitor profiles (explaining visitor identity, device environment, browsing purpose, proficiency, and main concerns), and web or specification links (providing publicly accessible website pages, prototype previews, design specifications, or competitor reference links), and want to organize them into actionable analysis or optimization results
When users need to turn materials related to the visual quality diagnostic assistant into clear conclusions, priorities, and next-step actions

How to Invoke

Call the AI Skills API directly through the exported Python runner:

Command Example

Basic Invocation

python3 scripts/run.py --params '{}'

Invocation with Common Parameters

python3 scripts/run.py --params '{"goal":"页面目标"}'

Parameter Description

Parameter	Type	Required	Default	Description
`goal`	string	No	-	Explain the information delivery, conversion, registration, consultation, purchase, or task operation the page is expected to complete
`audience`	string	No	-	Explain visitor identity, device environment, browsing purpose, proficiency, and main concerns
`materialUrl`	string	No	-	Provide publicly accessible website pages, prototype previews, design specifications, or competitor reference links; a complete accessible URL is required
`reviewDepth`	string	No	`标准诊断`	Choose quick checkup, standard specification review, or in-depth review; optional values:`快速体检`、`标准诊断`、`深度改稿`
`materialFile`	string	No	-	Supports desktop/mobile web screenshots, design specifications, wireframes, PDFs, review notes, or page annotation images
`materialText`	string	No	-	Paste web copy, page structure, design specification excerpts, component descriptions, or the issues currently intended to be checked
`targetPlatform`	string	No	-	Choose desktop web, mobile web, responsive official website, SaaS backend, or another page type
`brandRequirements`	string	No	-	Supplement brand visual specifications, component rules, copy tone, accessibility requirements, and information that must be retained

See the complete machine-readable parameter structure at references/form-schema.json。

Parameter Value Reference

The current skill has no categorical parameters that require additional table lookup.

Supported input formats

The current 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":"页面目标"}'

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 page goal (explain the information communication, conversion, registration, consultation, purchase, or task operations you want the page to accomplish.), visitor profile (explain the visitor's identity, device environment, browsing purpose, proficiency, and main concerns.), and web page or specification links (fill in publicly accessible website pages, prototype previews, design specifications, 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 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: default https://ai-skills.ai
AISKILLS_API_KEY: required, used for authenticated calls
AISKILLS_TENANT_ID: default default