Link Curator Obsidian Vault
dodo-reach/hermes-link-curator
Archives links a user sends into a profile's Obsidian-style vault with a save script and replies with a one-word confirmation instead of a summary.
Pulls a Xiaohongshu post's text, image text and video subtitles or transcript into a Markdown note saved in an Obsidian folder, in Chinese.
SKILL.md written in Chinese; this summary is our English description.
The automated check flagged lines worth reading first. See the safety section below.
$ npx skills add chenxiachan/xhs-claude-skills --skill xhs -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install chenxiachan/xhs-claude-skills xhs --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/chenxiachan/xhs-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/xhs .claude/skills/xhs && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "xhs" agent skill from https://github.com/chenxiachan/xhs-claude-skills/tree/master/skills/xhs into .claude/skills/xhs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/chenxiachan/xhs-claude-skills/tree/master/skills/xhsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add chenxiachan/xhs-claude-skills --skill xhs -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install chenxiachan/xhs-claude-skills xhs --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/chenxiachan/xhs-claude-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/xhs .agents/skills/xhs && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "xhs" agent skill from https://github.com/chenxiachan/xhs-claude-skills/tree/master/skills/xhs into .agents/skills/xhs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add chenxiachan/xhs-claude-skills --skill xhs -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install chenxiachan/xhs-claude-skills xhs --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/chenxiachan/xhs-claude-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/xhs .cursor/skills/xhs && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "xhs" agent skill from https://github.com/chenxiachan/xhs-claude-skills/tree/master/skills/xhs into .cursor/skills/xhs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/chenxiachan/xhs-claude-skills.git --path skills/xhs--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add chenxiachan/xhs-claude-skills --skill xhs -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install chenxiachan/xhs-claude-skills xhs --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/chenxiachan/xhs-claude-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/xhs .gemini/skills/xhs && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "xhs" agent skill from https://github.com/chenxiachan/xhs-claude-skills/tree/master/skills/xhs into .gemini/skills/xhs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install chenxiachan/xhs-claude-skills xhsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add chenxiachan/xhs-claude-skills --skill xhs -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/chenxiachan/xhs-claude-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/xhs .github/skills/xhs && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "xhs" agent skill from https://github.com/chenxiachan/xhs-claude-skills/tree/master/skills/xhs into .github/skills/xhs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add chenxiachan/xhs-claude-skills --skill xhs -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install chenxiachan/xhs-claude-skills xhs --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/chenxiachan/xhs-claude-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/xhs .opencode/skills/xhs && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "xhs" agent skill from https://github.com/chenxiachan/xhs-claude-skills/tree/master/skills/xhs into .opencode/skills/xhs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xhs", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
xhsPulls a Xiaohongshu post's text, image text and video subtitles or transcript into a Markdown note saved in an Obsidian folder, in Chinese.
You give the agent a Xiaohongshu link. It first looks for a cookies file at `~/cookies.json` exported from a logged-in Chrome session and, if it is missing, explains how to export one and stops. It then reads the post ID and `xsec_token` from the URL, requests the page with those cookies and parses the post data from `window.__INITIAL_STATE__`. If the page redirects to an error, the cookies have expired and you are asked to export them again.
For video posts it prefers subtitles embedded by the platform and only falls back to downloading the video, extracting 16000 Hz mono audio with ffmpeg and transcribing it with a Whisper large-v3-turbo model through `mlx_whisper`, then cleans the text and removes temporary files. For image posts it runs OCR when the description is short and there are several images. The result is saved as Markdown under `~/Documents/Obsidian Vault/xhs`. The excerpt is truncated in the OCR step.
2 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit e140727. It shows what the files ask for, not the result of running them.
Pre-approves these tools, so the agent can use them without asking each time:
BashReadWriteEditGlobGrepFrom allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
curlffmpegFrom the folder's file list and the shell code blocks in SKILL.md.
Hosts in commands or code, which the agent is likely to contact:
xiaohongshu.comFrom URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Xiaohongshu Post Extractor loads about 1.5k tokens when it runs. Until then it costs about 12 tokens; SKILL.md has 215 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found patterns that need a careful read before installing.
- Cookies 文件: `~/cookies.json`(从 Chrome 导出的小红书 cookies)2. 如果不存在,告知用户需要从 Chrome 导出 cookies:allowed-tools: Bash, Read, Write, Edit, Glob, GrepAutomated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from chenxiachan/xhs-claude-skills at commit e140727, republished under its MIT licence (© chenxiachan). 215 words, ~1,490 tokens.
.claude/skills/xhs/SKILL.md (or your agent's skills folder).用户希望提取小红书帖子内容。请按以下步骤处理:
~/cookies.json(从 Chrome 导出的小红书 cookies)~/Documents/Obsidian Vault/xhsmlx-community/whisper-large-v3-turbo用户提供的小红书链接: $ARGUMENTS
~/cookies.json 是否存在copy(JSON.stringify(document.cookie.split('; ').map(c => {
const [name, ...rest] = c.split('=');
return { name, value: rest.join('='), domain: '.xiaohongshu.com', path: '/',
expires: Date.now()/1000 + 86400*30, size: name.length + rest.join('=').length,
httpOnly: false, secure: false, session: false, priority: 'Medium',
sameParty: false, sourceScheme: 'Secure', sourcePort: 443 };
})))~/cookies.json从 URL 中提取帖子 ID(24 位十六进制字符串)和 xsec_token 参数。
使用 Python 脚本,通过 Cookies 请求帖子页面 HTML,从 window.__INITIAL_STATE__ 解析全部帖子数据:
import json, urllib.request, ssl, re
with open('<Cookies 文件>') as f:
cookies = json.load(f)
cookie_str = '; '.join(f"{c['name']}={c['value']}" for c in cookies)
ctx = ssl.create_default_context()
ctx.check_hostname = False
ctx.verify_mode = ssl.CERT_NONE
req = urllib.request.Request('<帖子URL>')
req.add_header('Cookie', cookie_str)
req.add_header('User-Agent', 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36')
resp = urllib.request.urlopen(req, timeout=15, context=ctx)
html = resp.read().decode('utf-8', errors='ignore')
m = re.search(r'window\.__INITIAL_STATE__\s*=\s*(\{.+?\})\s*</script>', html, re.DOTALL)
raw = m.group(1).replace('undefined', 'null')
data = json.loads(raw)
# 帖子数据在: data['note']['noteDetailMap'][<key>]['note']
# 包含: title, desc, type, time, user, imageList, video, interactInfo, ipLocation如果请求失败(被重定向到 404/错误页),说明 cookies 过期,提示用户按步骤 0 重新导出。
如果帖子 type 为 video,优先使用平台内嵌字幕,仅在无字幕时回退到本地 Whisper 转录。
从步骤 2 获取的视频数据中检查是否有内嵌字幕:
note['video']['media'] 或 note['video']['mediaV2'](JSON 字符串,需二次解析)
-> 查找 subtitles 字段
-> 优先级:source > zh-CN > en-US
-> 取对应语言的 SRT URL如果找到字幕 URL:
# 注意:字幕 CDN 域名必须使用 HTTPS(HTTP 可能超时)
curl -sL --connect-timeout 10 -o /tmp/xhs_{post_id}.srt \
-H "User-Agent: Mozilla/5.0" \
-H "Referer: https://www.xiaohongshu.com/" \
"<字幕URL(确保 https://)>"解析 SRT 文件,合并为连续文本(去除时间戳和序号),按语义断句重新组织段落。 字幕比 Whisper 转录更准确,且无需下载视频,应优先使用。
仅当步骤 3a 未找到字幕时,执行以下子步骤:
提取视频 URL:
note['video']['media']['stream'] -> 按 h264 > h265 > av1 优先级取第一个的 masterUrl下载视频并提取音频:
curl -L -o /tmp/xhs_{post_id}.mp4 -H "Referer: https://www.xiaohongshu.com/" <视频URL>
ffmpeg -y -i /tmp/xhs_{post_id}.mp4 -vn -acodec pcm_s16le -ar 16000 -ac 1 /tmp/xhs_{post_id}.wav语音转录:
import mlx_whisper
result = mlx_whisper.transcribe("/tmp/xhs_{post_id}.wav",
path_or_hf_repo="mlx-community/whisper-large-v3-turbo", language="zh", verbose=False)rm -f /tmp/xhs_{post_id}.mp4 /tmp/xhs_{post_id}.wav /tmp/xhs_{post_id}.srt如果帖子 type 为 normal(图文帖子),且图片中可能包含大量文字内容(如长文截图、PPT 翻拍、信息图表等),执行以下子步骤进行 OCR 识别。
判断是否需要 OCR: 如果帖子 desc 已经包含完整的文章内容(超过 500 字),通常不需要 OCR。但如果 desc 较短(如仅有标题或几句引言),而图片数量较多(≥3 张),则图片很可能是文章的载体,需要 OCR 提取。
从步骤 2 获取的 imageList 中提取每张图片的 urlDefault URL。
关键:必须将 HTTP URL 改为 HTTPS(HTTP 连接小红书图片 CDN 可能超时)。
使用 curl 批量下载:
# 单张下载
curl -sL --connect-timeout 10 -o /tmp/xhs_{post_id}_img_{序号}.jpg \
-H "Referer: https://www.xiaohongshu.com/" \
-H "User-Agent: Mozilla/5.0" \
"<图片URL(http:// 替换为 https://)>"
# 批量下载(curl 多输出模式,一条命令下载所有图片)
curl -sL --connect-timeout 10 \
-H "Referer: https://www.xiaohongshu.com/" \
-H "User-Agent: Mozilla/5.0" \
-o /tmp/xhs_{post_id}_img_00.jpg "<URL_0>" \
-o /tmp/xhs_{post_id}_img_01.jpg "<URL_1>" \
...使用 Claude Code 的 Read 工具读取每张图片(多模态能力,直接识别图中文字)。
注意多图限制: Claude 的多图上下文限制为每张图片最长边 ≤ 2000px。每次最多同时读取 4 张图片,超过 4 张需分批读取。
# 分批读取,每批最多 4 张
Read /tmp/xhs_{post_id}_img_00.jpg
Read /tmp/xhs_{post_id}_img_01.jpg
Read /tmp/xhs_{post_id}_img_02.jpg
Read /tmp/xhs_{post_id}_img_03.jpg
# (下一批)
Read /tmp/xhs_{post_id}_img_04.jpg
...从每张图片中提取所有中文/英文文字内容,按图片顺序拼接为完整文章。
rm -f /tmp/xhs_{post_id}_img_*.jpg将内容整理为 Markdown 文件,保存到 <Obsidian 保存目录>/{YYYY-MM-DD} {短标题}.md。
{发布日期} {短标题}.md,短标题不超过15个字,是核心洞察的极简概括<Obsidian 保存目录>/img/ 或 <Obsidian 保存目录>/video/写作风格:Peter Thiel 式——直接、反直觉、一句话给判断。笔记是决策工具,不是知识库。用户扫一眼就能决定:深挖还是跳过。
文件结构(无 YAML frontmatter):
# 一句话核心洞察(反直觉的判断,不是描述性标题)
核心论点,2-3句话。直接给出"大多数人觉得X,但其实Y"的判断。
不废话,不铺垫,像 Thiel 在董事会上说话。
**与我的关联:** 一句话。读取用户的 memory(~/.claude/projects/*/memory/ 下的
user 和 project 类型记忆)了解用户背景、研究方向和当前工作,据此说清楚
这个内容跟用户有什么关系。如果 memory 不可用,从通用的个人发展/工具/方法论角度切入。
**值得深挖吗:** 是/否。一句话理由。
> [!tip]- 详情
> 帖子核心内容的结构化整理(折叠状态,点开才看到):
> - 从 desc、视频字幕/转录、图片 OCR 文字中提炼,清理 `#xxx[话题]#` 标记
> - 按逻辑结构分节,保留关键数据和结论
> - 纯装饰性图片用 `` 嵌入
> - 含大量文字的图片:嵌入 OCR 提取的结构化文本(不嵌入图片 URL)
> - 视频帖子在此处放整理后的字幕/转录内容
> [!info]- 笔记属性
> - **来源**: 小红书 · 作者名
> - **帖子ID**: xxx
> - **链接**: 原始链接
> - **日期**: YYYY-MM-DD
> - **类型**: image/video
> - **互动**: N赞 / N收藏 / N评论
> - **标签**: 标签1, 标签2, ...关键约束:
urlDefault 字段的 URL© chenxiachan, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in skills/xhs of chenxiachan/xhs-claude-skills.
Open the folder on GitHubat commit e140727
Xiaohongshu Post Extractor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Xiaohongshu Post Extractor this skillchenxiachan/xhs-claude-skills | 421 | — | ~1.5k | Automated safety check: Warn | MIT | |
| Link Curator Obsidian Vaultdodo-reach/hermes-link-curator | 142 | — | ~2.8k | Automated safety check: Pass | MIT | |
| Obsidian Web Clipper Templatesdavila7/claude-code-templates | 32k | 7 repos | ~632 | Automated safety check: Pass | MIT | |
| Obsidian CLIpablo-mano/Obsidian-CLI-skill | 450 | — | ~3.2k | Automated safety check: Pass | None | |
| Daily Notes Workflowballred/obsidian-claude-pkm | 1.9k | — | ~2k | Automated safety check: Pass | MIT | |
| Summarize Callreysu/ai-life-skills | 269 | — | ~3.8k | Automated safety check: Notes | MIT |
dodo-reach/hermes-link-curator
Archives links a user sends into a profile's Obsidian-style vault with a save script and replies with a one-word confirmation instead of a summary.
davila7/claude-code-templates
Builds importable JSON templates for the Obsidian Web Clipper by checking your Bases, analyzing a sample page and drafting the template.
pablo-mano/Obsidian-CLI-skill
Lets the agent read, write, search and tidy an Obsidian vault directly through the official Obsidian command-line interface.
ballred/obsidian-claude-pkm
Creates today's daily note in an Obsidian vault and guides morning, midday and evening routines for planning, task review and reflection.
reysu/ai-life-skills
Transcribe a call recording with speaker diarization, summarize it, and create Obsidian vault notes (call note, transcript, person notes for participants).
AgriciDaniel/claude-obsidian
Creates, inspects and updates Obsidian JSON Canvas boards in a vault, with text, file, link, group and edge nodes, using safe recoverable edits.
chenxiachan/xhs-claude-skills
Creates a Xiaohongshu-style 3:4 cover image from a title by building an HTML page in one of six visual styles and capturing it with Playwright.
chenxiachan/xhs-claude-skills
分析已提取的小红书收藏内容,做 AI 总结、对比、提炼
chenxiachan/xhs-claude-skills
批量提取小红书帖子,整理为本地 Markdown 知识库
Works with
Pulls a Xiaohongshu post's text, image text and video subtitles or transcript into a Markdown note saved in an Obsidian folder, in Chinese. You give the agent a Xiaohongshu link.json` exported from a logged-in Chrome session and, if it is missing, explains how to export one and stops.
Xiaohongshu Post Extractor fits situations like: saving a Xiaohongshu article post as a Markdown note; getting a transcript or subtitles from a Xiaohongshu video post; extracting text from image-only posts such as screenshots of long articles.
Run `npx skills add chenxiachan/xhs-claude-skills --skill xhs -a claude-code`. Or copy the skill folder (skills/xhs in chenxiachan/xhs-claude-skills) into .claude/skills/xhs in your project. Claude Code loads it when a task matches its description.
Run `npx skills add chenxiachan/xhs-claude-skills --skill xhs -a codex`. Or copy the skill folder (skills/xhs in chenxiachan/xhs-claude-skills) into .agents/skills/xhs in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add chenxiachan/xhs-claude-skills --skill xhs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/xhs, .gemini/skills/xhs, .github/skills/xhs and .opencode/skills/xhs in your project.
Going by SKILL.md and its folder, Xiaohongshu Post Extractor needs the command-line tools its instructions call (curl and ffmpeg). Our summary lists: Cookies exported from a logged-in Chrome session and saved as `~/cookies.json`; Python and `curl`; `ffmpeg` and `mlx_whisper` for video transcription; An Obsidian vault folder at `~/Documents/Obsidian Vault`. Its frontmatter pre-approves these tools: Bash, Read, Write, Edit, Glob, Grep.
SKILL.md names 1 domain. In commands or code: xiaohongshu.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.
Our automated static check of SKILL.md flagged 2 warning(s): mentions a credentials file (ssh keys, cloud or package-manager tokens). Read the flagged lines before installing; the check is not a guarantee either way.
Xiaohongshu Post Extractor is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Xiaohongshu Post Extractor: Link Curator Obsidian Vault (dodo-reach/hermes-link-curator, 142 stars), Obsidian Web Clipper Templates (davila7/claude-code-templates, 32k stars), Obsidian CLI (pablo-mano/Obsidian-CLI-skill, 450 stars) and Daily Notes Workflow (ballred/obsidian-claude-pkm, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
chenxiachan (a GitHub user) maintains it in chenxiachan/xhs-claude-skills, which has 421 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on August 14, 2026.
Source: chenxiachan/xhs-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.