zsxq-topic

Original：🇨🇳 Chinese

Translated

Knowledge Planet Topic Management: Search topics, view details, publish posts, post comments, answer questions, set featured topics and tags. Used when users need to find content, post, comment, answer questions, or manage topics.

117installs

Sourceunnoo/zsxq-skill

Added on2026-04-17

NPX Install

npx skill4agent add unnoo/zsxq-skill zsxq-topic

SKILL.md Content (Chinese)

View Translation Comparison →

topic (v1)

CRITICAL — MUST use the Read tool to read
../zsxq-shared/SKILL.md
before starting, which contains authentication and error handling rules.

Core Concepts

Topic: Content unit within the Planet, uniquely identified by
```
topic_id
```
. Types:
- ```
talk
```
  : Regular post (images and text)
- ```
q&a
```
  : Question, can be answered by the Planet Owner
- ```
article
```
  : Long article
Comment: Reply under a topic, identified by
```
comment_id
```
, supports nested replies (
```
replied_comment_id
```
).
Digested: The Planet Owner can mark high-quality topics as digested for prominent display within the Planet.

Resource Relationships

Group (group_id)
└── Topic (topic_id) — talk / q&a / article
    ├── Comment (comment_id)
    │   └── 楼中楼 Reply (replied_comment_id)
    ├── Answer（q&a 类型专属）
    └── Hashtag 标签列表

Important Notes

Must Confirm Before Write Operations

Posting, commenting, and answering are irreversible public operations. Must confirm with the user before execution:

Target Planet / Topic (group_id / topic_id)
Content to publish (title / content / text)

Obtaining topic_id

When unsure of the topic_id, query first before proceeding:

Keyword search:

topic +search --group-id xxx --query "keywords"

Browse latest:
```
group +topics --group-id xxx
```
View details:
```
topic +detail --topic-id xxx
```

Shortcuts (Recommended for Priority Use)

Shortcuts are advanced encapsulations of common operations (

zsxq-cli topic +<verb> [flags]

). Prioritize using operations with Shortcuts.

Shortcut	Description
`+search`	Full-text search for topics within the Planet, returns a table of topic_id / type / title / time
`+detail`	Get complete details of a single topic (content, comment count, like count, tags, etc.)
`+create`	Publish a new topic (post) in the specified Planet, execute after confirming content
`+reply`	Post a comment on a topic, supports nested replies, execute after confirming content
`+answer`	Publish an official answer to a q&a type topic, execute after confirming content

API (Directly Called via

zsxq-cli api call

)

Advanced operations not covered by Shortcuts:

Tool	Parameters	Description
`get_topic_comments`	`topic_id` , `limit` , `index`	Get topic comment list (pagination)
`set_topic_digested`	`topic_id` , `digested`	Set/cancel digested status (Planet Owner permission)
`set_topic_tags`	`topic_id` , `titles`	Set tags for a topic (array of tag names)
`get_self_question_topics`	`topic_filter` , `count` , `end_time`	View questions initiated by yourself ( `unanswered` / `answered` )

zsxq-topic

NPX Install

Tags

SKILL.md Content (Chinese)

topic (v1)

Core Concepts

Resource Relationships

Important Notes

Must Confirm Before Write Operations

Obtaining topic_id

Shortcuts (Recommended for Priority Use)

API (Directly Called via
`zsxq-cli api call`
)

zsxq-topic

NPX Install

Tags

SKILL.md Content (Chinese)

topic (v1)

Core Concepts

Resource Relationships

Important Notes

Must Confirm Before Write Operations

Obtaining topic_id

Shortcuts (Recommended for Priority Use)

API (Directly Called via zsxq-cli api call)

API (Directly Called via
`zsxq-cli api call`
)