ai-content-writer

ai-content-writer Copy Diagnosis Assistant

Quick Start

More Skills

Overview

The Copy Diagnosis Assistant is used to answer "Can this copy move people?", for content production, copy optimization, and publishing 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 the topic, draft or reference materials, pasted topic, draft, channel requirements, reference materials, selling point information, or publishing goals. and other inputs, organize key context, and output content diagnosis, optimization suggestions, and an execution checklist, making it easy to continue execution, review, or delivery.

When to Use

Applicable Scenarios

• The user asks questions such as "Can this copy move people?" and needs to quickly break down the goal, determine priorities, and form actionable results
• Content creators, marketing, operations, and content media need to generate content diagnosis, optimization suggestions, and an execution checklist around the Copy Diagnosis 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 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 hopes to organize them into actionable analysis or optimization results
• The user needs to turn materials related to the Copy Diagnosis Assistant into clear conclusions, priorities, and next steps

How to Call

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

Command Example

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 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 the topic, draft, channel requirements, reference materials, selling point information, or publishing goals
brandRequirements	string	No	-	Supplement brand tone, channel rules, formatting 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 currently accepts JSON parameters directly; if the parameters include link fields, please pass complete, accessible URLs.

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 the user's goals that can be directly read, reviewed, or delivered.
• Interpretation of input materials: combine the content goal (state the desired publishing goal, conversion goal, rewriting direction, or evaluation criteria.), target audience (state the audience the content is aimed at, their role, buying stage, or usage scenario.), 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 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 questions about the "Copy Diagnosis Assistant".
• Then check whether the results cover the content diagnosis, optimization suggestions, and execution checklist, and whether clear next steps are given.
• 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