unnoo/zsxq-skill
5 skills11.4k installs785 starsGitHub
Install
npx skills add https://github.com/unnoo/zsxq-skillSkills in this repo
1Zsxq Sharedzsxq-shared is the foundational agent skill for builders who run 知识星球 (Zsxq) communities and automate work through zsxq-cli. It centralizes authentication with RFC 8628 device authorization, status and logout flows, configuration inspection, and the patterns for listing and invoking low-level API tools or raw HTTP paths. Agents learn how to compose correct share URLs for desktop and mobile, follow write and delete guardrails, resolve common errors such as expired tokens and missing parameters, and know when to suggest user NPS feedback. Other zsxq skills in the repo depend on these rules so commands stay consistent and safer. Use it on first login, when tokens expire, when debugging 401/403 responses, or whenever you need raw API access beyond a single feature skill. It assumes zsxq-cli is installed locally and does not replace official Zsxq product policy or content moderation judgment.2.3kinstalls2Zsxq Notezsxq-note documents how an agent should drive the zsxq-cli shortcuts for 知识星球 (ZS XQ) notes: creating public text-and-image notes, validating output JSON, optionally editing, and deleting with clear failure semantics. Solo builders and creators who distribute updates on Chinese knowledge communities install the shared zsxq auth setup, then use this skill when they want the agent to draft the copy but keep humans in the loop—every write path stresses confirmation because published notes are world-readable via link. The workflow encodes operational hygiene: confirm content and attachments, run create with `--json` to capture note_id and create_time, re-fetch detail to sanity-check, and treat delete as permanent. It complements topic-create skills for full-circle posts versus lightweight note pages. Network credentials live in the broader zsxq-shared stack; this package is the note-specific command reference and guardrails.2.3kinstalls3Zsxq Topiczsxq-topic documents how an agent should answer questions on Zsxq (知识星球) using the zsxq-cli shortcut for official responses. Solo creators who run paid communities install it when they want agent-assisted drafting and publishing without confusing public comments with the one-shot official answer slot. The skill is explicit about risk: +answer is a public write, irreversible per topic, and must be preceded by human confirmation of the target topic and final text. The recommended flow fetches topic detail JSON, checks type equals q&a, optionally discovers unanswered queues, then runs +answer with optional file attachments and --json output. Failed writes roll back atomically so the once-only quota is not consumed on bad params. It complements broader zsxq automation for operators who already authenticate the CLI in their environment.2.3kinstalls4Zsxq Groupzsxq-group is an agent skill package for the zsxq-cli shortcuts that list knowledge-planet memberships and in-group topic hashtags. Solo and indie builders who pay into 知识星球 circles use it when an AI coding agent needs stable identifiers—group_id from `group +list` and hashtag_id from `group +hashtags`—before calling topic browse or search APIs. The skill documents required flags, table versus JSON output shapes, and follow-on `api call get_hashtag_topics` pagination with end_time. It is not a brainstorming or planning methodology; it is a narrow CLI integration aimed at research and content workflows that depend on authenticated community data rather than scraping public pages.2.3kinstalls5Zsxq Userzsxq-user documents two zsxq-cli shortcuts for solo builders active on 知识星球: user +footprints and user +info. Footprints answers “what did I post, everywhere?” by scanning every planet you’re in, with optional limits, JSON export, and time-based paging. +info loads the current session’s profile for IDs and account metadata agents need before deeper group or topic skills. The skill is CLI-shaped reference material—parameters, output tables, empty-list vs error cases, and pointers to zsxq-shared and group-topics—so coding agents run the right commands without guessing ZSXQ semantics. It fits builders who treat community posts as part of distribution and retention, not a one-off chat task.2.3kinstalls