Skill v1.0.1
currentAutomated scan100/100+5 new
version: "1.0.1" name: siyuan-sisyphus description: CLI-only top-level skill for operating SiYuan Note through siyuan-sisyphus. Use to choose a scenario workflow, discover live command help, handle paths and IDs, paginate results, and apply safety rules.
SiYuan Sisyphus with the CLI
Use the narrowest scenario skill that matches the task. For unfamiliar fields, inspect siyuan-sisyphus list and siyuan-sisyphus help <tool> <action> before calling an action; live action help is the parameter-level source of truth.
Scenario routing
| Scenario | Skill | |
|---|---|---|
| Browse notebooks, documents, paths, IDs, and blocks | siyuan-sisyphus-browse-read | |
| Create documents or edit blocks | siyuan-sisyphus-create-edit | |
| Fulltext, SQL, backlinks, references, and replacement | siyuan-sisyphus-search-query | |
| Attribute views, columns, rows, and cells | siyuan-sisyphus-database | |
| Assets, extraction, and exports | siyuan-sisyphus-file-export | |
| Tags, decks, cards, and review | siyuan-sisyphus-tag-flashcard | |
| Permissions, system information, and dangerous operations | siyuan-sisyphus-system-cli | |
| Rich Markdown, math, diagrams, and SiYuan markup | siyuan-markup-guide |
Tool choice
Prefer fs for ordinary human-readable workspace paths. Use document or block for IDs, storage paths, metadata, or block-granular changes. Use av for real databases rather than Markdown tables. Low-complexity feedback and mascot actions need no separate scenario skill.
siyuan-sisyphus system get-version --json
siyuan-sisyphus notebook list --json
siyuan-sisyphus fs tree --path '/Notebook' --max-depth '3' --json
siyuan-sisyphus fs read --path '/Notebook/Folder/Doc' --block-start '0' --block-limit '50' --token-budget '2000' --json
Shared invariants
- Read
/AGENTS.mdthroughfsbefore workspace-aware tasks when it exists. - A workspace path such as
/Notebook/Folder/Doc, an hpath such as/Folder/Doc, and a storage path such as/20260712123000-abc123.syare different values. - Read before writing; after a mutation, read the affected object again.
- For document reads, continue with
nextWindowor explicitblockStart/blockLimit/tokenBudget; for list and search results, use their page parameters. - Missing results may be caused by notebook permissions or indexing delay.
- Obtain explicit approval before deletes, moves, bulk replacement, permission changes, local upload/export, or sensitive workspace disclosure.