marketing-psychology

marketing-psychology copy diagnosis assistant

Overview

The copy diagnosis assistant is used to answer "Can this copy resonate?", conversion rate, growth marketing, and copywriting questions. It is suitable for marketing, operations, product, and sales to invoke after clarifying business goals, content materials, or analysis objects. It combines psychological path materials, pasted page copy, offer descriptions, user feedback, sales scripts, or funnel descriptions to help judge motivation... and other inputs, organize key context, and output summaries, diagnostic conclusions, action recommendations, and reusable deliverables for continued execution, review, or delivery.

When to Use

Applicable Scenarios

Users ask questions such as "Can this copy resonate?" and need to quickly break down goals, determine priorities, and form actionable 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 the desired behavior (for example, building trust, reducing hesitation, completing a trial, booking a demo, purchasing, repurchasing, or referring.), the target user's psychological background (supplement user profile, decision role, awareness stage, main concerns, purchase motivation, and usage context.), and an experience or page link (fill in a publicly accessible page, product, campaign, quote page, or funnel preview link.), and hope to organize them into actionable analysis or optimization results
Users need to turn materials related to the copy diagnosis assistant into clear conclusions, priorities, and next actions

How to Invoke

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

Command Examples

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, building trust, reducing hesitation, completing a trial, booking a demo, purchasing, repurchasing, or referring
`audience`	string	No	-	Supplement user profile, decision role, awareness stage, main concerns, purchase motivation, and usage context
`materialUrl`	string	No	-	Fill in a publicly accessible page, product, campaign, quote page, or funnel preview link; a complete accessible URL is required
`reviewDepth`	string	No	`标准诊断`	Choose quick check, standard diagnosis, or deep psychological path analysis; optional values:`快速体检`、`标准诊断`、`深度改稿`
`materialFile`	string	No	-	Supports materials such as docx, pdf, md, txt, suitable for submitting campaign plans, page drafts, sales materials, or research excerpts
`materialText`	string	No	-	Paste page copy, offer descriptions, user feedback, sales scripts, or funnel descriptions to help judge motivation and resistance
`targetPlatform`	string	No	-	For example, official website, landing page, email, social media, ads, in-app, sales presentation, or offline scenarios
`brandRequirements`	string	No	-	Supplement brand values, prohibited expressions, compliance reminders, evidence that must be retained, and persuasion methods that cannot be used

See the complete machine-readable parameter structure in 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 contain link fields, 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 desired behavior (for example, building trust, reducing hesitation, completing a trial, booking a demo, purchasing, repurchasing, or referring.), the target user's psychological background (supplement the user profile, decision-making role, cognitive stage, main concerns, purchase motivation, and usage scenario.), and the experience or page link (fill in a publicly accessible page, product, campaign, pricing page, or funnel preview link.) 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 "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 the input materials are limited, 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