zsxq-skill
One skill and a CLI for the Knowledge Planet service: post search and publishing, replies, tags and scenarios for group owners.
- 323 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Publishes, edits and deletes posts and comments from your account, although it asks for confirmation before writing.
- Skill Pay scenarios create payment orders through WeChat Pay, and the user authorizes the payment personally.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/zsxq-skillDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Publishes, edits and deletes posts and comments from your account, although it asks for confirmation before writing.
- Skill Pay scenarios create payment orders through WeChat Pay, and the user authorizes the payment personally.
This is third-party code. Review the repository files before installing.
What it does
zsxq-skill connects an agent to private groups of the Chinese service Knowledge Planet (知识星球, zsxq). The agent lists groups, searches and reads topics, publishes, edits and deletes posts, answers comments and questions, sets tags, marks featured posts, assembles columns and keeps personal notes. A single `zsxq` skill is installed, and it picks the channel itself. If `zsxq-cli` is on the machine, commands go through it, otherwise through the `call_zsxq_api` MCP tool with an api-key. On top of the commands sit 12 scenarios for group owners: a daily patrol, comment triage, weekly reports, a daily poster as PNG, a vertical video, negative content monitoring, bulk tagging and reminders for members whose subscription is expiring.
Who it is for. Owners and administrators of Knowledge Planet groups who handle questions, run columns and prepare reports with AI.
Good fit when
- In the morning you want new topics, unanswered questions and fresh comments of a group in one sweep.
- Comments piled up under posts, and you need reply drafts for members' questions.
- The best posts of the week need tags, a featured mark and a place in a column.
- At the end of the week a report on new and active members and top posts is prepared.
- Members whose subscription ends soon receive a reminder.
Not a fit when
- You need other communities: the skill only knows Knowledge Planet.
- The agent must not publish in your name: every write operation runs from your account.
- You want to pay outside WorkBuddy: Skill Pay is supported there only.
- You cannot sign in to the account: the skill works after OAuth authorization or with an api-key.
Example request
Show which groups I belong to and find today's unanswered questions in my group.Limitations
The skill works only with Knowledge Planet and from your account: sign-in uses OAuth and the token is kept in the system keychain. Writes and deletions run after confirmation, yet they publish and erase real posts. Skill Pay payment scenarios are supported only in WorkBuddy and need the `weixinpay_pay` tool on the host side, with the user paying personally. The documentation and integration target the Chinese-language service. The repository calls itself an official project of the service team but belongs to a personal account, and nothing outside the repository confirms it.
How to disable. Delete the `zsxq` skill from the agent's skills directory and the CLI with `npm uninstall -g zsxq-cli`. The api-key is revoked on the service's own key management page.
FAQ
How do I install the skill and sign in?
Run `npm install -g zsxq-cli`, then `npx skills add https://github.com/unnoo/zsxq-skill --yes` and `zsxq-cli auth login`. The last command prints a link and a code to authorize in a browser or on a phone.
Can I skip the CLI?
Yes. Create a key on the service's key management page, copy the MCP link with the api-key and add it to the agent settings. The skill then calls the `call_zsxq_api` tool.
Which operations need confirmation?
Any write or delete: publishing, editing, commenting, answering, changing tags or the featured mark, group settings and notes. The command reference flags such calls with a warning sign.
What does the skill do when several groups match?
It lists candidates with their id and name and waits for your choice. It does not take the first group that matches by name.
How do I move from the old five skills?
Install the new skill and ask the agent to check and migrate the old one. The agent first produces a report and removes the previous skills only after your confirmation.
Discussion
No questions or reviews yet.
Related
Skills15 skills for Codex that cover Xiaohongshu content from account research and topic choice to title, draft and pre-publish QA
The xhs command-line tool for Xiaohongshu with a ready skill: the agent searches notes, reads comments and posts as you.
14 skills and a CLI save videos, podcasts and articles to a local Markdown base and find quotes in it with a source link
An OpenClaw skill that runs a Xiaohongshu account through the built-in browser: feed analysis, ideas, note drafting, comment replies and a knowledge base
Two dozen skills: video scripts and covers, publishing to X and Substack, security scanners, Claude Code session export
A set of 131 redfoxdata skills for Chinese social data and content: search, account analysis, video downloads, titles and banned-word checks
README in short
The description splits work into three layers: ready scenarios, atomic commands and an exploration mode where the agent finds what it needs in the API list. It has a safety section, command examples for groups, topics, notes and the profile, and direct API calls through `api call` and `api raw`.
README badge
Original SKILL.md
---
name: zsxq
description: "知识星球 CLI（zsxq-cli）与底层接口完整操作指南，涵盖星球和内容管理、Skill Pay 微信支付场景。当用户提到知识星球、zsxq、小密圈、星球、登录/认证、发帖、评论、回答、编辑、删除主题、定时发布/定时任务/定时回答、投票、问答主题、markdown 正文、AI 声明（aigc/personal_perspective）、置顶、精华、标签/hashtag、成员、足迹、提问记录、分享链接、NPS 反馈、Skill Pay、微信支付、查询星球价格/续费价格/轻读价格、付费加入、续费/续期、礼品卡、付费提问、赞赏用户/主题/评论、购买轻读、购买创建星球邀请码、创建订单、group_id、topic_id、comment_id，需要登录/查看认证状态、查看/搜索/发布/编辑/管理知识星球内容、做星球AI搜索总结 / 按相关度总结搜索结果 / 搜不到时列出最贴近的主题、修改星球名称/简介/背景图/亮点图（星球设置）、做每日巡场 / 评论区运营 / 提问管理 / 精华与标签整理 / 运营日报周报复盘 / 生成星球日报海报图片 / 生成竖版动画视频 / 负面内容监控 / 批量打标签 / 到期成员续费关怀 / 收录主题到专栏等运营场景、拼接分享链接、直接调用底层接口（api call / api raw / call_zsxq_api）、知识星球 MCP 接入 / api-key、查成员列表 / 成员到期时间 / 专栏 column 列表，或询问知识星球产品规则与常见问题（退款条件 / 退款要多久 / 手续费多少 / 费率是多少 / 提现多久到账 / 怎么开发票 / 企业认证要什么材料 / 分享有赏比例 / 为什么审核不通过 / 为什么打不开 / 违规封禁规则 / 用户协议隐私政策等，读官方帮助中心 doc.zsxq.com 后回答），或需要检查/迁移/清理旧版知识星球 skill（zsxq-shared、zsxq-group 等升级到单一 zsxq）时，必须使用本 Skill。即使只涉及单一操作（如获取 group_id、查看帖子详情、回复评论），也应触发"
metadata:
version: "3.0.0"
channels: "cli（zsxq-cli，优先）/ mcp（call_zsxq_api，兜底）"
cliHelp: "zsxq-cli --help"
---
# 知识星球操作指南（CLI / MCP 双通道）
本 Skill 覆盖通过 zsxq-cli（CLI 通道）或底层接口工具 call_zsxq_api（MCP 通道）操作知识星球的所有场景：认证、星球管理、主题管理、用户信息、笔记管理，以及 Skill Pay 微信支付。
> **默认假设 zsxq-cli 已安装且已登录**，无需每次主动检查。只在命令执行报错时才按需处理（见 [`references/auth-errors.md`](references/auth-errors.md)）。
> 本 Skill 所有示例中的 ID、订单号、支付码等标识均为模拟数据，不对应真实资源。执行操作时必须通过查询结果或用户输入取得并核对真实标识，不得直接复用示例值。
## 执行通道
本 Skill 的所有能力有两条执行通道，先判定通道再路由：
1. 宿主可执行 `zsxq-cli` → **CLI 通道**（优先；shortcut 有参数校验与本地编排，行为最可控）
2. 否则宿主工具列表中存在 `call_zsxq_api` → **MCP 通道**
3. 两者都没有 → 停止并提醒用户：安装 CLI（见 [`references/auth-errors.md`](references/auth-errors.md)）或在宿主中接入知识星球 MCP（密钥管理页创建 api-key 后复制链接接入），由用户选择
- 通道判定是一次性环境探测；选定后一致使用，不混用。仅当某操作标注「仅 CLI 通道」/「仅 MCP 通道」时，对该操作单独切换或告知用户。
- MCP 通道下所有调用都通过底层接口工具 `call_zsxq_api`（参数 `{method, path, query?, body?}`）；**不得臆造未文档化的 method/path**——能力底表见 [`references/endpoint-catalog.md`](references/endpoint-catalog.md)，未覆盖即视为不支持。
- 「执行模式」路由（场景 → 原子 → 探索）在两条通道下相同；通道只决定各 reference「## 命令」节使用哪一组调用块。
## 执行模式
按以下顺序路由用户请求，命中即执行，不再往下走：
1. **场景模式** — 请求命中[已注册场景](#场景scenarios)：读场景入口文档，按流程编排原子操作
2. **原子操作** — 请求明确对应一个常用操作：读对应 reference，直接调用推荐命令
3. **探索模式** — 都未命中：按 [`references/cli-exploration.md`](references/cli-exploration.md) 通过 CLI 帮助和 API 列表发现能力
> 原子操作和场景执行时**不得**预先运行无关的 `doctor`、`--help` 或 `api list`。仅在能力不匹配或调用失败时回退到探索模式。
## 快速索引
根据用户意图，直接跳转到对应小节或 reference：
| 用户想要… | 去哪看 |
|----------|--------|
| 登录 / 查看登录状态 / 排查认证或 HTTP 错误 | → [`references/auth-errors.md`](references/auth-errors.md) |
| 每日巡场：查今天需要关注/处理的新内容 | → [`scenarios/daily-patrol.md`](references/scenarios/daily-patrol.md) |
| 整理评论区、找未回复评论并起草回复 | → [`scenarios/triage-comments.md`](references/scenarios/triage-comments.md) |
| 处理别人向我提的、还没回答的问题 | → [`scenarios/manage-inbound-questions.md`](references/scenarios/manage-inbound-questions.md) |
| 整理精华与标签（加精 / 打标签建议） | → [`scenarios/curate-digest-and-tags.md`](references/scenarios/curate-digest-and-tags.md) |