suyuan2022/suyuan-skill

What it solves

AI agents often give you walls of text you don't want to read, generic answers that are technically correct but useless, or they can't help you get your own data out of a cloud service. This project collects three practical skills that fix those specific frustrations: one turns hard concepts into simple diagrams, one forces the AI to think like an expert before answering, and one migrates your Get Notes (biji.com) data to your own computer.

How it works

Each skill is a set of instructions the agent reads when triggered. You install them via a command like npx skills add suyuan2022/suyuan-skill -g, which places them in your user directory so they work across all projects. You can install all three or pick just one. Every time your agent starts a task, it reads the descriptions of all installed skills, so the author advises installing only what you actually use to avoid wasting the agent's attention.

• whatis – when you don't understand a concept or the agent's text is too long, you invoke it (e.g., /whatis 美联储加息为什么会让房贷变贵). It generates a single HTML page dominated by diagrams (flowcharts, sequence diagrams, architecture diagrams, before/after comparisons) with very little text. If context is insufficient, it first searches your files or the web, and every box in the diagram must be backed by evidence – no invented facts. It's adapted from an Anthropic ELI5 idea with added typography and structure requirements for more reliable output.
• break-ai-slop – this makes the agent answer four questions before starting any open-ended task: Who does this best in real life and in what situation? What does a beginner's or AI's botched result look like? If common mistakes are avoided and it's still wrong, what's the root problem? What constraints truly decide success? Only after thinking through these does it start. You can trigger it by saying "this isn't a throwaway, think carefully first" or using /break-ai-slop. It's meant for writing, planning, and judgment tasks, not facts or typos – output gets twice as long.
• get-biji – for Get Notes (biji.com) users. It syncs all your recordings, saved links, and quick notes to local Markdown files organized by date. New items can be pulled incrementally. Transcripts include speaker and timestamps, and long ones get their own file. Because the files are yours, your agent can search them alongside your other notes, and you keep them even if Get changes or goes offline. It also uses Get's free transcription quota: you can paste a Douyin, Xiaohongshu, Bilibili, or Xiaoyuzhou link and Get parses it into text; for other sites or local audio, you upload to Get and it deducts from your monthly quota (the agent tells you the approximate cost beforehand). Transcription happens inside a temporary Get note that the skill deletes afterward, leaving your other notes untouched. Setup requires running npm install && npx playwright install chromium (about 250MB download, used only for login). First use opens a browser to log into biji.com, so it must run on your own computer. After that, you stay logged in for roughly 90 days. Converting local audio/video also needs ffmpeg. Notes are stored in a directory you specify; login state is in ~/.config/get-biji/ and survives reinstall or updates. This skill is based on skychentian/GET-biji with author permission; sync part is from the original, transcript script was added.

Who it's for

People who use AI agents (like Claude Code or similar) for real work and hit these common frustrations: not understanding a concept, getting bland generic output, or wanting to own and reuse data locked in a note-taking app. The skills are installed globally so they work with any project your agent handles.

Highlights

• Diagram-first explanations – whatis renders concepts as visual HTML pages with minimal text, choosing the best diagram type for the topic.
• Evidence-based diagrams – every box must be justified; the agent checks your files or the web if needed.
• Anti-slop thinking routine – break-ai-slop's four questions force the agent to consider real-world context, failure modes, root causes, and true constraints before acting.
• Local ownership of Get Notes – full export to Markdown with speaker-tagged transcripts, incremental updates, and offline access.
• Transcription without extra tools – uses Get's own quota to convert links or uploads, with cost warning upfront.
• Works across projects – global installation means any project your agent touches can use these skills.
• MIT licensed – free to use and modify.