ai-paid-ads

ai-paid-ads Paid Ads Diagnostic Assistant

Quick Start

More Skills

Overview

The paid ads diagnostic assistant is used to answer "Was the ad money well spent?", for content production, copy optimization, and publishing preparation. It is suitable for content creators, marketers, operations staff, and content media to call after clarifying business goals, content materials, or analysis targets. It will combine inputs such as the topic, draft or reference materials, pasted topic, draft, channel requirements, reference materials, selling point information, or publishing goals, organize the key context, and output conversion questions, compliance risks, and a creative iteration checklist for continued execution, review, or delivery. Capability positioning supplement: ad creative diagnostics can combine hot search content trends and platform compliance boundaries.

When to Use

Applicable Scenarios

• The user asks questions like "Was the ad money well spent?" and needs to quickly break down goals, determine priorities, and form actionable results
• Content creators, marketers, operations staff, and content media need to generate conversion questions, compliance risks, and a creative iteration checklist around the paid ads diagnostic assistant
• The user has already prepared content goals (explain the desired publishing goals, conversion goals, rewriting direction, or evaluation criteria.), target audience (explain the audience, roles, purchase stages, or use scenarios the content is aimed at.), and reference content links (fill in publicly accessible articles, pages, competitor content, or reference links; for restricted content, please upload or paste instead.), and wants to organize them into actionable analysis or optimization results
• The user needs to turn materials related to the paid ads diagnostic assistant into clear conclusions, priorities, and next steps

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, roles, purchase stages, or use scenarios 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 the topic, draft, channel requirements, reference materials, selling point information, or publishing goals
brandRequirements	string	No	-	Supplement brand tone, channel rules, format requirements, unchangeable facts, compliance restrictions, or key points for pre-publishing review

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

Parameter Value Reference

This skill currently has no categorical parameters that require an additional lookup table.

Supported Input Formats

This skill directly accepts JSON parameters; if a parameter contains 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

• Conversion issues, compliance risks, creative iteration checklist: organize the core results around the user's goals that can be directly read, reviewed, or delivered.
• Input material interpretation: combine the content goal (explain the intended publishing goal, conversion goal, rewriting direction, or evaluation criteria.), target audience (explain the audience the content is aimed at, their roles, purchase stage, or usage scenario.), reference content links (fill in publicly accessible articles, pages, competitor content, or reference links; for restricted content, please upload or paste instead.) to extract key context and the basis for judgment.
• Next steps: provide priorities, execution suggestions, or a content framework that can continue to be developed.

Suggestions for using the results

• First determine whether the output answers the user's core question about the "Paid Advertising Diagnostic Assistant".
• Then check whether the results cover conversion issues, compliance risks, and the creative iteration checklist, 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