Overview
The Persuasive Copy Assistant is used to answer "Is this copy persuasive?", content production, copy optimization, and publish preparation. It is suitable for content creators, marketing, operations, and content media to call after clarifying business goals, content materials, or analysis targets. It will combine inputs such as topic, draft or reference materials, pasted topic, draft, channel requirements, reference materials, selling point information, or publishing goals, organize key context, and output content diagnosis, optimization suggestions, and action checklists for further execution, review, or delivery.
When to Use
Applicable Scenarios
- When users ask questions like "Is this copy persuasive?" and need to quickly break down the goal, determine the focus, and form executable results
- Content creators, marketing, operations, and content media need to generate content diagnosis, optimization suggestions, and action checklists around the Persuasive Copy Assistant
- Users have already prepared 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.), and want to organize them into executable analysis or optimization results
- Users need to turn materials related to the Persuasive Copy Assistant into clear conclusions, priorities, and next 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 topics, drafts, channel requirements, reference materials, selling point information, or publishing goals |
brandRequirements |
string | No | - | Add 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 additional lookup.
Supported Input Formats
This skill directly accepts JSON parameters; if a parameter contains a link field, pass a complete, accessible URL.
Example Request
The example parameters below can be passed directly to scripts/run.py, 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
- Content diagnosis, optimization suggestions, execution checklist: organize core results around user goals that can be directly read, reviewed, or delivered.
- Interpretation of input materials: extract key context and judgment basis based on content goals (state the intended publishing goals, conversion goals, rewriting direction, or evaluation criteria.), target audience (describe the audience, roles, buying stages, or usage scenarios the content is aimed at.), reference content links (provide publicly accessible articles, pages, competitor content, or reference links; for restricted content, upload or paste it instead.).
- 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 "Persuasive Copywriting Assistant".
- Then check whether the results cover content diagnosis, optimization suggestions, and an execution checklist, and whether they provide clear next steps.
- If the input materials are insufficient, it is recommended to have the user supplement the goals, audience, constraints, or original materials before running.
Preparation before running
AISKILLS_BASE_URL: defaulthttps://ai-skills.aiAISKILLS_API_KEY: required, used for authenticated callsAISKILLS_TENANT_ID: defaultdefault