feat(skills): add SiYuan Note and Scrapling as optional skills#3742
feat(skills): add SiYuan Note and Scrapling as optional skills#3742
Conversation
Add two new optional skills: - siyuan (optional-skills/productivity/): SiYuan Note knowledge base API skill — search, read, create, and manage blocks/documents in a self-hosted SiYuan instance via curl. Requires SIYUAN_TOKEN. - scrapling (optional-skills/research/): Intelligent web scraping skill using the Scrapling library — anti-bot fetching, Cloudflare bypass, CSS/XPath selectors, spider framework for multi-page crawling. Placed in optional-skills/ (not bundled) since both are niche tools that require external dependencies. Co-authored-by: FEUAZUR <FEUAZUR@users.noreply.github.com>
|
I have an existing SiYuan skill at @eloklam/siyuan-agent that takes a different approach — a Node.js CLI wrapper instead of raw curl commands. The key difference is safety-by-default: read operations work out of the box, but write operations require an explicit write=true flag, and notebook-level mutations (create/remove notebook, etc.) are hard-blocked entirely. (Notebook is like Vault in Obsidian) This prevents autonomous agents from accidentally deleting notebooks or mutating data without intent. It also includes additional commands like backlinks, outline, and a generic call wrapper for arbitrary endpoints with the same guardrails. The SKILL.md documents the same API surface but wraps it in a protective layer. |
|
@FEUAZUR Would you like to look into it? |
…esearch#3742) Add two new optional skills: - siyuan (optional-skills/productivity/): SiYuan Note knowledge base API skill — search, read, create, and manage blocks/documents in a self-hosted SiYuan instance via curl. Requires SIYUAN_TOKEN. - scrapling (optional-skills/research/): Intelligent web scraping skill using the Scrapling library — anti-bot fetching, Cloudflare bypass, CSS/XPath selectors, spider framework for multi-page crawling. Placed in optional-skills/ (not bundled) since both are niche tools that require external dependencies. Co-authored-by: FEUAZUR <FEUAZUR@users.noreply.github.com>
Yes why not |
3 participants
Salvage of #2829 by @FEUAZUR — moved from bundled
skills/tooptional-skills/since both are niche tools with external dependencies.What this PR does
Adds two new optional skills that users can install via
hermes skills install official/<category>/<name>:SiYuan Note (
optional-skills/productivity/siyuan/, 297 lines)SIYUAN_TOKENenv var + running SiYuan instancehermes skills install official/productivity/siyuanScrapling (
optional-skills/research/scrapling/, 335 lines)pip install scrapling+scrapling installfor browser binarieshermes skills install official/research/scraplingWhy optional-skills/ instead of skills/
Both are niche: SiYuan has a small English-speaking user base, and Scrapling is a specialized library requiring external dependencies. Bundled skills should be broadly useful to most users — these fit better as opt-in installs.
Files changed
optional-skills/productivity/siyuan/SKILL.md(new, 297 lines)optional-skills/research/scrapling/SKILL.md(new, 335 lines)