# Xhs Account Decompose

> Performs deep teardown of a single Xiaohongshu (小红书) creator account — extracts profile, existing tags, audience persona from comment IPs, title formulas, content forms, and concrete improvement directions. Use when the user asks to 拆解这个博主 / 拆这个号 / 分析对标账号 / 这个账号怎么做起来的 / 学这个博主怎么做 / decompose this xhs creator / analyze this xiaohongshu account.

- **Type:** Skill
- **Install:** `agentstack add skill-jeorrysyd-xhs-viral-decoder-xhs-account-decompose`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Jeorrysyd](https://agentstack.voostack.com/s/jeorrysyd)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Jeorrysyd](https://github.com/Jeorrysyd)
- **Source:** https://github.com/Jeorrysyd/xhs-viral-decoder/tree/main/skills/xhs-account-decompose

## Install

```sh
agentstack add skill-jeorrysyd-xhs-viral-decoder-xhs-account-decompose
```

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

## About

# xhs-account-decompose — 单号深度拆解

5-section deep teardown of any Xiaohongshu account, modeled after the 「萧萧Carol-style」 reference report.

## When to use

User pastes a Xiaohongshu profile URL and asks:
- 「深度拆解这个博主：」
- 「 这个号怎么做起来的？」
- 「学一下这个对标账号」
- 「Tell me how this xhs creator does it」

## Quick start

```bash
python3 shared/lib/cli.py account-decompose \
  --url "https://www.xiaohongshu.com/user/profile/?xsec_token="
```

If URL has no `xsec_token` (e.g., from app share), the skill will:
1. Extract nickname from any of their notes (search by user_id)
2. Re-resolve a fresh token from search results

## What it produces

5-section docx in Feishu folder:

1. **账号基本信息** — nick / fans / IP / bio / total engagement / 爆款率 / 大爆率
2. **现有标签** — bio self-tags + title high-frequency words + title formula distribution
3. **目标人群画像** — comment IP geography + theme distribution + identity self-disclosures + comment length stats
4. **爆款公式与内容框架** — TOP 5 viral notes detail + dominant formula analysis + form distribution
5. **可改进方向** — content direction / formula ROI / form mix / posting cadence / matrix opportunity / **3 specific actions to copy**

## Workflow detail

See [workflow.md](workflow.md).

## Composition with other skills

- **Pair with `xhs-matrix-identify`** if account looks matrix-ready (bio @ other accounts, multiple linked profiles)
- **Pair with `xhs-persona-synth`** to use this account's persona insights for your own rewrite

## Failure modes — feishu output is REQUIRED

The skill **must** end with a Feishu doc URL handed back to the user. If feishu push fails for any reason, **stop and ask the user to fix the configuration**. Do NOT silently degrade to local-only output.

| Failure | Action |
|---|---|
| `lark-cli` binary not in PATH | STOP. Tell user to install lark-cli per [setup/02_install_lark_cli.md](../../setup/02_install_lark_cli.md). |
| `lark-cli` auth expired (`LarkAuthExpired`) | STOP. Tell user: `lark-cli auth login --as bot` |
| Bot lacks scope (`LarkScopeMissing`) | STOP. Show the `scope_url` from the error; user grants in 1 click in 飞书 console. |
| `config.yaml` missing `feishu.folder_token` | STOP. Tell user to edit `config.yaml`. |

Local markdown / JSON files saved during the run are intermediate artifacts — they are **not** the deliverable.

## Examples

See [examples.md](examples.md) and [../../examples/account_decompose_sample.md](../../examples/account_decompose_sample.md).

## Source & license

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

- **Author:** [Jeorrysyd](https://github.com/Jeorrysyd)
- **Source:** [Jeorrysyd/xhs-viral-decoder](https://github.com/Jeorrysyd/xhs-viral-decoder)
- **License:** MIT

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-jeorrysyd-xhs-viral-decoder-xhs-account-decompose
- Seller: https://agentstack.voostack.com/s/jeorrysyd
- 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%.