ai-copywriting

ai-copywriting Copy Diagnosis Assistant

Overview

The Copy Diagnosis Assistant is used to answer "Can this copy resonate?", content production, copy optimization, and publishing preparation. It is suitable for content creators, marketing professionals, operations teams, and content media to invoke after clarifying business goals, content materials, or analysis targets. It combines inputs such as topic, draft or reference materials, pasted topic, draft, channel requirements, reference materials, selling point information, or publishing goals, organizes key context, and outputs persuasion diagnosis, copy-ready rewrites, and risk word alerts for continued execution, review, or delivery. Capability positioning supplement: copy rewriting is the platform's most direct business-oriented input-output capability.

When to Use

Applicable Scenarios

Users ask questions like "Can this copy resonate?" and need to quickly break down goals, determine priorities, and form actionable results
Content creators, marketing professionals, operations teams, and content media need to generate persuasion diagnosis, copy-ready rewrites, and risk word alerts around the Copy Diagnosis Assistant
Users have already prepared content goals (explaining the desired publishing goals, conversion goals, rewriting direction, or evaluation criteria.), target audience (explaining the audience, roles, purchase stages, or usage scenarios 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 wish to organize them into actionable analysis or optimization results
Users need to turn Copy Diagnosis Assistant-related materials into clear conclusions, priorities, and next-step 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	-	Explain the desired publishing goals, conversion goals, rewriting direction, or evaluation criteria
`audience`	string	No	-	Explain the audience, roles, purchase stages, or usage 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 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

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

Parameter Value Reference

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

Supported Input Formats

This skill directly accepts JSON parameters; if the parameters contain link fields, please provide complete, accessible URLs.

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

Persuasiveness diagnosis, copy-ready revisions, and risk word alerts: organize the core results around the user's goals that can be directly read, reviewed, or delivered.
Input material interpretation: combine the content goal (state the intended publishing goal, conversion goal, rewriting direction, or evaluation criteria.), target audience (state the audience, role, purchasing stage, or usage scenario the content is aimed at.), and reference content links (provide publicly accessible articles, pages, competitor content, or reference links; for restricted content, upload or paste it instead.) to extract key context and the basis for judgment.
Next steps: provide priorities, execution suggestions, 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 persuasiveness diagnosis, copy-ready revisions, and risk word alerts, and whether they provide clear next steps.
If there is little input material, it is recommended to have the user supplement the goal, audience, constraints, or original material 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