Agent Skills › leamsigc/ShortsGenerator › twitter-research-report

twitter-research-report

GitHub

基于Twitter研究数据生成最终HTML报告，包含受众评分矩阵、帖子分析及预定义的互动回复策略，用于追踪和展示研究成果。

skills/twitter-research-report/SKILL.md leamsigc/ShortsGenerator

Trigger Scenarios

需要生成Twitter/X研究报告时汇总分析结果并输出可视化HTML报告时

Install

npx skills add leamsigc/ShortsGenerator --skill twitter-research-report -g -y

More Options

Use without installing

npx skills use leamsigc/ShortsGenerator@twitter-research-report

指定 Agent (Claude Code)

npx skills add leamsigc/ShortsGenerator --skill twitter-research-report -a claude-code -g -y

安装 repo 全部 skill

npx skills add leamsigc/ShortsGenerator --all -g -y

预览 repo 内 skill

npx skills add leamsigc/ShortsGenerator --list

SKILL.md

Frontmatter

{
    "name": "twitter-research-report",
    "version": "3.0.0",
    "description": "Report state — generates the final HTML report (REPORT.html) from\nraw-posts.json, audience-scores.json, content-drafts.json, and\nengagement-responses.json. Includes audience scoring matrix, top post\nanalysis, content drafts, and pre-defined engagement responses for every\ntopic post. Saves engagement-responses.json for tracking.\n",
    "allowed-tools": [
        "Bash",
        "Read",
        "Write",
        "ChromeDevTools"
    ]
}

Twitter/X Research — Report State (v3)

Generates the final HTML report with audience scoring, post links, and engagement responses.

Preconditions

Config exists: .twitter-research/<timestamp>/config.json
Raw posts exist: .twitter-research/<timestamp>/raw-posts.json (10+ topic posts)
Analysis exists: .twitter-research/<timestamp>/audience-scores.json
Content drafts exist: .twitter-research/<timestamp>/content-drafts.json

Steps

1. Generate engagement responses (per topic post)

For EVERY post in raw-posts.json posts[], craft 3 response types the user can post as replies to build presence on the topic:

Type	Strategy	Limit	Tone
Value add	Build on the tweet's point with an expert insight	1-3 sentences	Helpful, authoritative
Discussion starter	Ask a thoughtful question that sparks replies	1-2 sentences	Curious
Agree + amplify	Agree strongly and add a personal take	1-2 sentences	Enthusiastic

Rules: never pitch the product, stay on-topic, reference specifics, end with a hook, keep it short.

Save to .twitter-research/<timestamp>/engagement-responses.json (schema: responses[] with targetPostUrl, targetHandle, postPreview, targetSegment, responses[{type, text, whyThisWorks}], tracking).

2. Generate REPORT.html

node "$CLAUDE_SKILL_ROOT/scripts/report-html.js" <timestamp>
# fallback: node ./skills/twitter-research/scripts/report-html.js <timestamp>

The script renders a self-contained dark-themed report from all JSON files:

Audience scoring matrix
Top posts with direct X links + engagement stats
Content drafts (social posts + video scripts)
Engagement responses (copyable, with Reply-on-X links)

Report Completion

✅ Twitter/X Research Report Complete!

Session: .twitter-research/<timestamp>/
📊 REPORT.html — open in browser
📁 audience-scores.json · content-drafts.json · engagement-responses.json