ai-ad-creative

ai-ad-creative Ad Creative Diagnostic Assistant

Overview

The Ad Creative Diagnostic Assistant is used to answer "Will this ad be clicked?", performance diagnostics, website quality, and experience metrics. It is suitable for technical, product, marketing, and software use after clarifying business goals, content materials, or analysis targets. It combines inputs such as topic, draft or reference materials, paste topic, draft, channel requirements, reference materials, selling point information, or publishing goals, organizes key context, and outputs creative diagnostics, selling point reinforcement suggestions, and iteration directions for continued execution, review, or delivery. Capability positioning supplement: ad creative review and revision is a high-frequency task understandable to C-end users.

When to Use

Applicable Scenarios

Users ask questions like "Will this ad be clicked?" and need to quickly break down goals, determine priorities, and form actionable results
technical, product, marketing, and software need to generate creative diagnostics, selling point reinforcement suggestions, and iteration directions around the Ad Creative Diagnostic Assistant
Users have already prepared content goals (explaining the desired publishing goals, conversion goals, rewriting direction, or evaluation criteria.), target audience (explaining the audience, role, purchase stage, or usage scenario the content is aimed at.), reference content links (fill in publicly accessible articles, pages, competitor content, or reference links; for restricted content, please upload or paste instead.), and want to organize them into actionable analysis or optimization results
Users need to turn materials related to the Ad Creative 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	-	Explain the desired publishing goals, conversion goals, rewriting direction, or evaluation criteria
`audience`	string	No	-	Explain the audience, role, purchase stage, or usage scenario the content is aimed at
`materialUrl`	string	No	-	Fill in publicly accessible articles, pages, competitor content, or reference links; for restricted content, please upload or paste instead; a complete accessible URL is required
`materialFile`	string	No	-	Upload drafts, brand materials, channel requirements, reference materials, or content planning files
`materialText`	string	No	-	Paste topic, draft, channel requirements, reference materials, selling point information, or publishing goals
`brandRequirements`	string	No	-	Supplement brand tone, channel rules, format requirements, immutable facts, compliance restrictions, or pre-publication review priorities

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 lookups.

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

Creative diagnosis, selling point reinforcement suggestions, iteration directions: organize the core results around user goals that can be directly read, reviewed, or delivered.
Interpretation of input materials: combined with content goals (explain the desired publishing goals, conversion goals, rewriting direction, or evaluation criteria.), target audience (explain the audience, role, purchase stage, or usage scenario the content is aimed at.), reference content links (fill in publicly accessible articles, pages, competitor content, or reference links; for restricted content, please upload or paste instead.) extract key context and bases for judgment.
Next steps: provide priorities, execution suggestions, 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 "Advertising Creative Diagnosis Assistant".
Then check whether the results cover creative diagnosis, selling point reinforcement suggestions, iteration directions, and whether they provide 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: default https://ai-skills.ai
AISKILLS_API_KEY: required, used for authenticated calls
AISKILLS_TENANT_ID: default default