# hashtag-optimization

hashtag-optimization is a Claude Code skill for choosing hashtags and topic tags on Xiaohongshu. It helps with post discovery, search visibility, and tag strategy.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 194 installs · ★ 564 repo stars
- Author: vivy-yi
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/vivy-yi/xiaohongshu-skills/tree/HEAD/skills/01-内容创作/hashtag-optimization/SKILL.md
- Updated: 2026-01-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/hashtag-optimization

## What it does

The skill groups tags into broad topics, niche terms, timely tags, and account-specific tags. Its research workflow draws on Xiaohongshu search suggestions, posts from similar accounts, and topic pages. Qiangua and Huitun Data are listed as optional services for checking tag popularity and competition.

It also covers where tags can go: in the post description, sometimes in the title, or on the final carousel slide. To compare tag sets, the guide proposes testing similar posts and tracking traffic sources, including search. Tags unrelated to a post’s subject can hurt its reach, so the strategy ties tag choice to content relevance.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add vivy-yi/xiaohongshu-skills --skill hashtag-optimization -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/hashtag-optimization/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/hashtag-optimization/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add vivy-yi/xiaohongshu-skills --skill hashtag-optimization -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/hashtag-optimization/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add vivy-yi/xiaohongshu-skills --skill hashtag-optimization -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/hashtag-optimization/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install vivy-yi/xiaohongshu-skills skills/01-内容创作/hashtag-optimization
```

2. **Manually: put the files in place**
- File: `.github/skills/hashtag-optimization/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add vivy-yi/xiaohongshu-skills --skill hashtag-optimization -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/vivy-yi/xiaohongshu-skills --path skills/01-内容创作/hashtag-optimization
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/hashtag-optimization/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add vivy-yi/xiaohongshu-skills --skill hashtag-optimization -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/vivy-yi/xiaohongshu-skills/tree/HEAD/skills/01-内容创作/hashtag-optimization/SKILL.md

## When to use it
- choose tags for a new Xiaohongshu post
- find niche terms for search discovery
- place tags in a post description or title
- compare tag sets by search traffic

## Example prompts
- Suggest tags for a Xiaohongshu post about dry, sensitive skin.
- Build a mix of broad, niche, and branded tags for this post.
- Compare these tag sets and outline how to track search traffic.

## Similar
- [hashtag-strategy](https://affpapa.org/en/nevibecode/skills/hashtag-strategy.md) — skill · 1400 installs
- [ig-hashtag-strategist](https://affpapa.org/en/nevibecode/skills/ig-hashtag-strategist.md) — skill · ★ 897 repo stars
- [analyzing-tiktok-hashtag-performance](https://affpapa.org/en/nevibecode/skills/analyzing-tiktok-hashtag-performance.md) — skill · 882 installs
- [monitoring-instagram-hashtag-trends](https://affpapa.org/en/nevibecode/skills/monitoring-instagram-hashtag-trends.md) — skill · 879 installs
- [linkedin-posts](https://affpapa.org/en/nevibecode/skills/linkedin-posts.md) — skill · 3700 installs
- [pinterest-posts](https://affpapa.org/en/nevibecode/skills/pinterest-posts.md) — skill · 2300 installs

From the same set: [vivy-yi/xiaohongshu-skills](https://affpapa.org/en/nevibecode/by/vivy-yi/xiaohongshu-skills.md) — 100 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
