# X Insight Cards

> Run scheduled or manual creator curation that turns recent high-quality X posts into verified image-and-caption packs for Douyin and Xiaohongshu review, with optional private delivery to a confirmed WeChat File Transfer Assistant self-chat. Use when Codex needs to discover, verify, rank, deduplicate, translate, render, quality-check, or privately deliver posts about wealth, life, goals, habits, a…

- **Type:** Skill
- **Install:** `agentstack add skill-ljunnan24-hash-x-insight-cards-x-insight-cards`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ljunnan24-hash](https://agentstack.voostack.com/s/ljunnan24-hash)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ljunnan24-hash](https://github.com/ljunnan24-hash)
- **Source:** https://github.com/ljunnan24-hash/x-insight-cards/tree/main/skills/x-insight-cards
- **Website:** https://skills.sh/ljunnan24-hash/x-insight-cards/x-insight-cards

## Install

```sh
agentstack add skill-ljunnan24-hash-x-insight-cards-x-insight-cards
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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:

```bash
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:

```bash
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](https://github.com/ljunnan24-hash)
- **Source:** [ljunnan24-hash/x-insight-cards](https://github.com/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.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ljunnan24-hash-x-insight-cards-x-insight-cards
- Seller: https://agentstack.voostack.com/s/ljunnan24-hash
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
