X Insight Cards

X Insight Cards

Automate the preparation of Douyin and Xiaohongshu content packs from public X posts. Produce a small, source-auditable set of post images and copy-ready Chinese captions. Optimize for insight quality, faithful attribution, natural Chinese typography, and human review—not volume.

Workflow

1. Read [references/workflow.md](references/workflow.md) before running a daily curation job.
2. Check the user's history file and existing output folders. Deduplicate by canonical URL and normalized English-text SHA-256.
3. Discover posts from the last 24 hours. Expand to 72 hours only when necessary; then use unused evergreen posts.
4. Verify each candidate's URL, author, handle, exact English text, publication date, and views when views are material to selection.
5. Reject politics, stock tips, medical advice, course sales, unattributed reposts, pure motivational filler, and unverifiable content.
6. Score candidates using [references/scoring.md](references/scoring.md). Select no more than five, sorted by score. Never pad below 75/100.
7. Translate faithfully. Preserve paragraphs, quotation marks, dashes, parentheses, and tone.
8. Render one card per selected post. Prefer a real post screenshot when the environment can capture it cleanly. Otherwise use scripts/render_card.py and label the record rearranged-render.
9. Write one concise Chinese caption per card: normally one sentence, at most two, followed by 3–5 relevant hashtags. Do not copy the translation.
10. Run the checks in [references/qa-checklist.md](references/qa-checklist.md) and mark accepted items READY_FOR_REVIEW.
11. When the user has configured private delivery, read [references/private-delivery.md](references/private-delivery.md), verify the self-chat destination, obtain any required send confirmation, and send each PNG plus its matching caption. Never upload or publish to a content platform.

Rendering

Install Pillow, then run:

python scripts/render_card.py \
  --input assets/demo-post.json \
  --output ./output/demo-card.png

The English post style is the fixed reference. Match Chinese to the English text's visual size, stroke darkness, line height, and color. On macOS, prefer PingFang SC Regular for Chinese regular text. Read [references/typography.md](references/typography.md) whenever typography or punctuation is in scope.

Ranking and deduplication

After assigning evidence-based score components, run:

python scripts/score_candidates.py \
  --input candidates.json \
  --history history.jsonl \
  --output ranked.json

Read [references/candidate-schema.md](references/candidate-schema.md) when preparing input data or consuming the output.

Output contract

Default deliverables:

• One source-attributed PNG per selected post, prepared as Douyin/Xiaohongshu creator material.
• One copy-ready Chinese caption per post in the response or a user-requested structured file.
• A private/auditable history record outside the public deliverable folder.
• When explicitly configured, private delivery of each PNG and matching caption to the user's confirmed WeChat File Transfer Assistant self-chat.

Do not add poster backgrounds, ratings, Chinese titles, commentary, decorative AI art, platform watermarks, or captions inside the card.

Safety and rights

• Use public, read-only sources. Never read, export, or store cookies, passwords, or access tokens.
• Do not bypass login challenges, rate limits, CAPTCHAs, or platform restrictions.
• Do not imply endorsement by X or any quoted author.
• Keep source links and attribution. Do not redistribute third-party media unless the user has the necessary rights.
• Never publish automatically. Private self-delivery is not publication and requires exact recipient verification plus any just-in-time confirmation required by the computer-control environment.
• A separate, explicit user request and platform-specific workflow is required for any social-platform upload.

Source & license

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

• Author: ljunnan24-hash
• Source: ljunnan24-hash/x-insight-cards
• License: MIT
• Homepage: https://skills.sh/ljunnan24-hash/x-insight-cards/x-insight-cards

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