Setup

Setup

Use this skill for first-time package setup and later preference updates.

Use This For

• first install of the package
• updating hot_topics preferences
• checking whether opencli is connected
• verifying the package can run end-to-end

Do Not Use This For

• daily topic collection after setup is already complete
• article drafting
• image generation requests

Inputs

• preferred hot topic directions
• preferred platforms
• optional request to re-run verification

Outputs

• updated config/user_preferences.json
• confirmation of dependency and connectivity state
• clear next-step guidance

Workflow

1. Check whether config/user_preferences.json already exists.
2. Ask the user to confirm or update preferred hot topics.
3. Save the preferences file if needed.
4. Verify opencli using python tools/opencli_fetcher.py --check or opencli doctor.
5. Verify config with python tools/config_loader.py.
6. Summarize readiness and recommend the next skill.

Default Preference Shape

{
  "hot_topics": ["AI工具", "SaaS", "AI出海"],
  "default_platforms": ["xiaohongshu", "zhihu", "bilibili", "twitter"],
  "output_dir": "output"
}

Fallback Guidance

• If user_preferences.json is missing, create it.
• If opencli is unavailable, continue with RSS-capable flows and explain which social sources are unavailable.
• If image provider keys are missing, explain that writing and pattern lookup can still proceed, but image-producing skills will fail.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: GiantClam
• Source: GiantClam/auto-viral-article-writer
• License: MIT

Install and usage instructions live in the source repository linked above.