ad-creative

ad-creative copy diagnosis assistant

Quick Start

More Skills

Overview

The copy diagnosis assistant is used to answer "Can this copy move people?", conversion rate, growth marketing, and copywriting, and is suitable for marketing, operations, product, and sales to invoke after clarifying business goals, content materials, or analysis targets. It will combine inputs such as ad creative scripts, pasted Hooks, video scripts, storyboards, static image copy, material descriptions, product selling points, 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

• Users ask questions such as "Can this copy move people?" and need to quickly break down goals, determine priorities, and form executable results
• Marketing, operations, product, and sales need to generate summaries, diagnostic conclusions, action recommendations, and reusable deliverables around the copy diagnosis assistant
• Users have already prepared creative goals (for example, dwell time, clicks, lead generation, purchases, installs, retargeting, brand awareness, or new product explanation.), target audience context (supplement audience pain points, usage scenarios, purchase stage, cultural context, creative sensitivities, and disliked expressions.), and creative preview links (fill in publicly accessible ad previews, material descriptions, landing pages, product pages, or reference links.), and hope to organize them into executable analysis or optimization results
• Users need to turn materials related to the copy diagnosis 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":"创意目标"}'

Parameter Description

Parameter	Type	Required	Default	Description
goal	string	No	-	For example, dwell time, clicks, lead generation, purchases, installs, retargeting, brand awareness, or new product explanation
audience	string	No	-	Supplement audience pain points, usage scenarios, purchase stage, cultural context, creative sensitivities, and disliked expressions
materialUrl	string	No	-	Fill in publicly accessible ad previews, material descriptions, landing pages, product pages, or reference links; a complete accessible URL must be provided
reviewDepth	string	No	标准诊断	Choose quick checkup, standard diagnosis, or deep creative breakdown; optional values:快速体检、标准诊断、深度改稿
materialFile	string	No	-	Supports creative materials such as docx, pdf, md, txt, suitable for submitting scripts, storyboards, creative briefs, or material descriptions
materialText	string	No	-	Paste Hooks, video scripts, storyboards, static image copy, material descriptions, product selling points, or user feedback
targetPlatform	string	No	-	For example, TikTok, Meta, YouTube, LinkedIn, Xiaohongshu, feed ads, display ads, or offline screens
brandRequirements	string	No	-	Supplement brand tone, visual/text restrictions, prohibited expressions, declaration requirements, and promises that cannot be exaggerated

For the complete machine-readable parameter structure, see references/form-schema.json。

Parameter Value Reference

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

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 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 creative goal (for example, dwell time, clicks, lead generation, purchase, installation, recall, brand awareness, or new product explanation.), target audience context (supplement audience pain points, usage scenarios, purchase stage, cultural context, creative sensitivities, and disliked expressions.), and creative preview link (fill in a publicly accessible ad preview, asset description, landing page, product page, or reference link.) 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 question about the "Copy Diagnosis 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